Skip to main content
Projects are the core of Michelangelo. Each project is a complete mobile app that you create, edit, and share from your iPhone.

Starting a New Project

  1. From the home screen, tap the prompt input.
  2. Describe the app you want to build in natural language.
  3. Optionally tap the image button to attach up to 2 images for visual reference.
  4. Submit the prompt.
The app navigates to the editor and starts generating your project.
You can also start from one of the AI-powered prompt suggestions shown on the home screen.

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:
  1. Sends the prompt to the Michelangelo AI backend.
  2. Creates the project and starts streaming progress in real time.
  3. Generates the initial files and saves them to the project.
  4. Prepares the files for the inline sandbox and renders the preview.
  5. 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.
You can iterate on the project by sending more prompts. Michelangelo applies edits as diffs and can auto-fix sandbox errors during a session.

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.
The source preference is managed automatically based on your device and settings.

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.