> ## 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 MagicOS

> Create a MagicOS, start or bring in a design, and ask for your first change.

In this guide you'll put a design on the canvas and ask the coordinator for a change. You don't need anything prepared, since you can start by describing what you want.

<Steps>
  <Step title="Create a MagicOS">
    Go to your [dashboard](https://www.magicpatterns.com/dashboard), click **Create**, and choose **MagicOS**. A new MagicOS opens, and the coordinator says hello and asks how you want to start.

    <Frame>
      <img src="https://cdn.magicpatterns.com/uploads/u7bZ2X4ASFzfCmDx7PZ2qt/dashboard-create.png" alt="The Create menu on the Magic Patterns dashboard" />
    </Frame>
  </Step>

  <Step title="Choose a way in">
    Start fresh by typing or talking to the coordinator about what you want to build. Or bring in something you already have: use **Insert** in the navbar to add a design, document, image, or GitHub repo to the canvas.
  </Step>

  <Step title="Open the design">
    Whether the coordinator built it or you inserted it, your design sits on the canvas. Double-click it to open it up and click around.
  </Step>

  <Step title="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 *"Make it mobile-first."*
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Next steps

<CardGroup cols={3}>
  <Card title="The canvas and files" icon="shapes" href="/docs/documentation/magic-os/canvas-and-files">
    Add documents, images, GitHub repos, and notes next to your designs.
  </Card>

  <Card title="Agents and threads" icon="messages" href="/docs/documentation/magic-os/agents-and-threads">
    Run several pieces of work at once and know when you're needed.
  </Card>

  <Card title="Publish a design" icon="globe" href="/docs/documentation/publishing/publish-url">
    Put a design from the canvas on a live URL.
  </Card>
</CardGroup>


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