Quick start
From a fresh account to a real build on a real Mac. About five minutes, most of which is the build itself.
You need a GitHub repository with an Xcode, Flutter or React Native project in it. Public or private both work.
01Create an account
Sign up with your email, or continue with GitHub.
If you signed up with an email address, we send you a confirmation link before you can sign in. It arrives within a minute or so and is valid for 24 hours. If it is not in your inbox, look in spam — and tell us which mail provider you use, because that is a problem on our side, not yours. Continuing with GitHub skips this step.
Either way you land on your dashboard with 200 free minutes for the month.
Before your first free build we ask for a card. We do not charge it. It is there because free build minutes are a standing target for crypto-mining abuse, and a card is the one thing that is expensive to fake at scale. Your dashboard has a Verify a card button; Stripe checks the card and we never see the number.
02Connect a repository
Open Repositories and choose Install the GitHub app. You will be sent to GitHub to install it, where you pick exactly which repositories we can see — not all of them unless you say so.
GitHub then sends you back here, and there is one more click. Press Choose repositories and tick the ones you want to build. The app being installed is not the same as a repository being connected — installing gives us permission, this step is where you say which repository to use it on. If you had already installed the app before, the button reads Already installed? Choose repositories and does the same thing.
A public repository can also be added by name, without the app: paste owner/name or its GitHub URL into the box on the same page and press Connect.
We ask for read access to your code and pull requests, and write access to checks and commit statuses, so we can put build results back on your pull requests. We never ask for write access to your code.
No repository yet? Add ours instead. On the Repositories page, under Or add a public repository by name, paste macbuildcloud/macbuildcloud-flutter-example and press Connect. It builds in about two and a half minutes and produces a real .apk and .ipa you can download.
03Tell us how to build it
Add a file called .macbuildcloud.yml to the root of your repository. Here is a complete one for an Xcode project:
script:
- xcodebuild -version
- xcodebuild -project MyApp.xcodeproj -scheme MyApp \
-destination "generic/platform=iOS" \
CODE_SIGNING_ALLOWED=NO \
build
artifacts:
- build/**/*.app
Flutter and React Native look much the same — see the Flutter and React Native guides.
You can also paste these steps into the dashboard instead of committing a file. That is useful while you are still working out what the build command should be: the dashboard version wins over the file, so you can iterate without pushing a commit every time.
The grey text inside that box is an example, not saved content — the box is empty until you paste your own steps and press Save build steps.
04Run it
Push a commit, or press Build on the repository page. The log streams live while it runs. A first Xcode build of a small app typically finishes in under two minutes.
When it ends you get the exit code, how long it ran, how much it cost, and any artifacts you asked for. Artifacts are encrypted on our disks and deleted after 30 days.
05Where to go next
- Build configuration — caching, environment variables, test reports, artifact patterns.
- Code signing — when you are ready to produce a signed .ipa or ship to TestFlight.
- API — trigger builds from your own tooling.
06If you get stuck
Every page of this documentation has a support@macbuildcloud.com link in the sidebar. Include your build number — the #123 at the top of the build page — and we can see exactly what happened on the machine.
Nothing on your dashboard takes money from your card without showing you the price first: every purchase goes through a checkout page with the amount on it. Builds draw on your balance instead, and Usage & billing always shows what is left.