> ## Documentation Index
> Fetch the complete documentation index at: https://www.magicpatterns.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Build your first prototype

> In this guide, learn how to start a new Magic OS Project and ask the agent to make a change. You don't need anything prepared, since you can start by describing what you want.

**1. Create a Magic OS**

Go to your [dashboard](https://www.magicpatterns.com/dashboard) and click **+ New Project**. Your new MagicOS opens, and you can choose how to start:

* **Start from an existing design:** continue a Magic Patterns design, along with its design system.
* **Import from Claude Design:** bring in a project you made in Claude Design.
* **Recreate from image:** upload a screenshot and turn it into a design.
* **Connect a GitHub repo:** build from your codebase.
* **Import your existing design system:** use one you already have in Magic Patterns.

You can also connect a coding agent like Claude Code, Cursor, or Codex from the **Chats** panel, or skip all of this and describe what you want in the chat.

![The New Project button on the Magic Patterns dashboard](https://cdn.magicpatterns.com/uploads/deC6sDkdN5qgEbJ4Q31B25/Create_new.png)

![Ways to start a new MagicOS, including an existing design, Claude Design, an image, GitHub, or a design system](https://cdn.magicpatterns.com/uploads/mqSqC2NQh95Vr6CKtFWrUh/create_new_2.png)

**2. Prompt your first prototype**

Start fresh by describing what you want to build. Or start from something you already have: use the **Insert** button **+** to add a design, document, image, or GitHub repo to the canvas, then type @ to mention it in your prompt.

![A prompt for a calorie tracking prototype](https://cdn.magicpatterns.com/uploads/58aMNC8g39necKYHYzRaCi/Calorie.png)

**3. Open the design**

Double-click it to open it up and click around.

<video controls playsInline aria-label="Opening a design by double-clicking it" src="https://cdn.magicpatterns.com/uploads/iLfcbeewBoEGDsbGU1GZuQ/CleanShot%202026-11-10%20at%2010.49.39%20AM.mp4" />

**4. Ask for a change**

Tell the coordinator what you want the way you'd brief a teammate. For example: *"Figure out a better layout for the home screen"* or *"Create a dark mode version with the same colours."*

**5. Watch the work**

The coordinator starts a thread and hands the job to an agent. Follow along in that thread or from the sidebar. New files show up on the canvas as they're built, and you can keep chatting with the coordinator in the meantime.

<video controls playsInline aria-label="An agent thread updating the prototype" src="https://cdn.magicpatterns.com/uploads/deuHMCi96pUPg6DrThqL9Q/CleanShot%202026-11-10%20at%2010.58.48%20AM.mp4" />

## Next steps

> [card] [The canvas and files](https://www.magicpatterns.com/docs/documentation/magic-os/canvas-and-files.md)
>
> Add canvases, prototypes, frames, documents, images, and resources.

> [card] [Prototypes and frames](https://www.magicpatterns.com/docs/documentation/projects/prototyping.md)
>
> Open a prototype or a frame to interact, inspect, or edit.

> [card] [Agents and threads](https://www.magicpatterns.com/docs/documentation/magic-os/agents-and-threads.md)
>
> Run several pieces of work at once and know when you're needed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.