> ## Documentation Index
> Fetch the complete documentation index at: https://subframe-59800133-apg-edit-updates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create your first project and export a design to code in minutes.

## Create your first project

1. Sign up at [subframe.com](https://subframe.com) to create your first project.
2. Configure your theme with quick presets or customize later in the Theme page.
3. Select a default navigation style for your app.

<img src="https://mintcdn.com/subframe-59800133-apg-edit-updates/h3QkDAiIDKnbbMvD/images/quickstart/quickstart-new-project.png?fit=max&auto=format&n=h3QkDAiIDKnbbMvD&q=85&s=9992f91e346ae9900ff543347585090e" alt="Component library gallery for a new project" width="1440" height="1080" data-path="images/quickstart/quickstart-new-project.png" />

After onboarding, you will see a blank project with the base component library set up.

## Design your first page

You can create a new page with AI or start from scratch.

<Steps>
  <Step title="Prompt with AI">
    <img src="https://mintcdn.com/subframe-59800133-apg-edit-updates/h3QkDAiIDKnbbMvD/images/quickstart/quickstart-prompt-ai.png?fit=max&auto=format&n=h3QkDAiIDKnbbMvD&q=85&s=909b077b6c0021f30d3429a57a990a4c" alt="Design with AI prompt dialog" width="1440" height="1080" data-path="images/quickstart/quickstart-prompt-ai.png" />

    Ask AI generates multiple design variations using your theme and components.

    1. Open your project and switch to **Ask AI** mode.
    2. Type a prompt for the page you want to design.
    3. Submit your prompt to open the page editor and wait for designs to generate.
    4. Select a variation to preview in the Ask AI panel.
    5. Click **Apply design** to add it to the current page.

    <Tip>Mix and match elements from different variations by dragging to the page from the preview.</Tip>
  </Step>

  <Step title="Edit in Design Mode">
    <img src="https://mintcdn.com/subframe-59800133-apg-edit-updates/h3QkDAiIDKnbbMvD/images/quickstart/quickstart-design-mode.png?fit=max&auto=format&n=h3QkDAiIDKnbbMvD&q=85&s=d0523ff193753d5e55d063480152f469" alt="Page editor in design mode" width="1440" height="1080" data-path="images/quickstart/quickstart-design-mode.png" />

    Switch to Design Mode to refine your page in the responsive page editor.

    * Drag-and-drop elements on the page to rearrange.
    * Select an element and click the **+** Insert buttons to add new elements inline.
    * Edit styles and properties in the Inspector panel on the right.
    * Right-click or press <kbd>/</kbd> for contextual edits to a selected element.
  </Step>
</Steps>

## Set up your codebase

Next, we'll create a new project using the Subframe Vite starter kit to implement your design. Open a new folder on your computer using Cursor or your favorite IDE.

<Steps>
  <Step title="Setup your project">
    See [Installation](/installation) for detailed instructions on setting up Subframe in a new or existing project.
  </Step>

  <Step title="Install the MCP server">
    <img src="https://mintcdn.com/subframe-59800133-apg-edit-updates/h3QkDAiIDKnbbMvD/images/quickstart/quickstart-setup-mcp.png?fit=max&auto=format&n=h3QkDAiIDKnbbMvD&q=85&s=3df0b72870968354d01312b4d9f37210" alt="Installation instructions for Claude Code, Cursor, and Codex MCP servers" width="1440" height="1080" data-path="images/quickstart/quickstart-setup-mcp.png" />

    In the page editor, open **Code** > **Installation** to view Claude Code, Cursor, or Codex instructions specific to your project.

    <Info>To learn more about the MCP server and its capabilities, see [MCP Server](/guides/mcp-server).</Info>
  </Step>

  <Step title="Initialize Subframe">
    <img src="https://mintcdn.com/subframe-59800133-apg-edit-updates/h3QkDAiIDKnbbMvD/images/quickstart/quickstart-cursor-init.png?fit=max&auto=format&n=h3QkDAiIDKnbbMvD&q=85&s=4015bc53eb2176f9d4e35b7343760a3e" alt="Cursor project with Subframe installation prompt" width="1440" height="1080" data-path="images/quickstart/quickstart-cursor-init.png" />

    Copy the installation prompt in **Code** > **Installation** for Claude Code, Cursor, or Codex and run it in your project's root folder.
  </Step>

  <Step title="Prompt to implement your design">
    <img src="https://mintcdn.com/subframe-59800133-apg-edit-updates/h3QkDAiIDKnbbMvD/images/quickstart/quickstart-mcp-link.png?fit=max&auto=format&n=h3QkDAiIDKnbbMvD&q=85&s=07c96ebcef6e11a634c674e5c3bb2496" alt="Code mode inspect view with link for MCP server" width="1440" height="1080" data-path="images/quickstart/quickstart-mcp-link.png" />

    Switch to **Code** > **Inspect** and copy the MCP link from Subframe to add to your prompt:

    > "Implement the design from this Subframe page \[YOUR\_PAGE\_MCP\_LINK]"

    AI fetches the code via MCP and adds business logic.
  </Step>

  <Step title="Start your development server">
    If you created a new project, you can start your development server with:

    ```bash theme={null}
    npm install
    npm run dev
    ```

    Open `localhost:3000`—your page renders exactly as designed.
  </Step>
</Steps>

You're all set! Your Subframe project is now connected and ready for development.

## Next steps

<CardGroup cols={2}>
  <Card title="Core concepts" icon="lightbulb" href="/learn/concepts">
    Understand how Subframe works under the hood.
  </Card>

  <Card title="Learn the editor" icon="square-mouse-pointer" href="/learn/editor">
    Discover how to design using Subframe's visual editor.
  </Card>

  <Card title="Go to developer docs" icon="code" href="/overview">
    Dive deeper into using Subframe for developer handoff.
  </Card>

  <Card title="Ask AI" icon="wand-sparkles" href="/learn/ask-ai">
    Explore AI-powered design features.
  </Card>
</CardGroup>
