Quickstart

Modaal builds native iOS apps from plain-language descriptions. You describe what you want, and the coding agent writes the code, builds it through Xcode, fixes the errors, and iterates with you. Here’s how to get from nothing to a running app.

​

1. Download and install Modaal

Get the app from modaal.dev/download and install it on your Mac. Modaal runs on macOS only — building iOS apps requires a Mac.

​

2. Connect a coding agent

Every project starts on the built-in free preview, so you can begin right away. To use a more capable model — or a subscription you already pay for (Claude, Codex, Gemini, Copilot, Cursor…) — connect your own agent from User Menu → Agent settings. See Connect your agent.

​

3. Set up Xcode

Xcode is what compiles and runs your app on the iOS simulator. You can start chatting and planning before it’s ready — Xcode only gates building and running. Install it, open it once to download an iOS simulator runtime, then confirm it in User Menu → Set up Xcode. Full walkthrough: Set up Xcode.

​

4. Describe what you want to build

Open a project and type your idea in plain language. Modaal turns it into a spec, plans the architecture, generates the code, and runs a build-and-fix loop through Xcode after each step — so you get a real native iOS project that stays maintainable as it grows. Review each step and steer as you go; the Modes and prompts guide shows how to get the most out of your prompts.