Starting a New Project
- From the home screen, tap the prompt input.
- Describe the app you want to build in natural language.
- Optionally tap the image button to attach up to 2 images for visual reference.
- Submit the prompt.
Prompt Input
The prompt input supports:- Free-form text up to 4000 characters.
- Up to 2 image attachments, compressed for fast upload.
- AI-generated suggestions to help you get started.
Generation Flow
When you submit a prompt, the app:- Sends the prompt to the Michelangelo AI backend.
- Creates the project and starts streaming progress in real time.
- Generates the initial files and saves them to the project.
- Prepares the files for the inline sandbox and renders the preview.
- Sends a notification when generation completes or fails.
The prompt request has a client-side timeout. If generation takes longer, the streaming channel keeps you updated.
Editor and Iteration
Once the project is created, the editor shows:- A live preview of the app.
- A prompt input at the bottom for follow-up requests.
- A header with the project name and a settings button.
AI Source Preference
Michelangelo can use different AI sources for suggestions and generation:- Cloud AI — the default backend-powered generation.
- On-device AI — local suggestions for compatible devices.
Project Metadata
- Name — auto-generated by the AI and editable from App Settings → Rename.
- Icon — generated in the background based on your project.
- Visibility — controlled by the Private App toggle in settings.
Next Steps
View App
Preview your app inside Michelangelo.
Prompt Engineering
Learn how to write effective prompts.

