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

# Canvas vs. Preview

> Learn the difference between Canvas and Preview in Replit, and when to use each for your projects.

Replit offers two ways to work on an app: **Canvas** and **Preview**. The best part? You can use them together—start with a beautiful design, refine it, then convert to a fully functional app when you're ready.

<Frame>
  <img src="https://mintcdn.com/replit/NqvyWjOnebeS7HrG/images/replitai/canvas-preview-toggle.png?fit=max&auto=format&n=NqvyWjOnebeS7HrG&q=85&s=a8c72c7986b4fba0d2dca5a4a0a9a735" alt="The Canvas and Preview toggle in the Workspace, with a tooltip explaining 'Switch back to Preview mode to interact with your creations at full size.'" width="2202" height="1410" data-path="images/replitai/canvas-preview-toggle.png" />
</Frame>

## What is Canvas?

[Canvas](/learn/design/canvas) lets you create beautiful, interactive websites and app designs in just a few minutes. Simply describe your idea and Replit builds it for you.

Canvas is perfect for:

* **Testing your ideas quickly**: Visualize your app's design before building functionality
* **Creating polished websites**: Landing pages, portfolios, restaurant menus, event pages
* **Fine-tuning your design**: Adjust colors, layouts, and content instantly

<Info>
  Canvas designs look and feel like real apps, but they don't store data or connect to external services yet. When you're happy with how everything looks, you can convert your design into a full app with one click. The steps below show you how.
</Info>

## What is Preview?

Preview shows your creation as a real, working application that can save data, let people sign in, and connect to other services. It's the interactive, full-size view of your app.

Use Preview when your app needs to:

* **User accounts**: Let people create accounts and log in
* **Save information**: Store data like orders, messages, or user preferences
* **Connect to other services**: Process payments, send emails, or pull in data from other apps
* **Handle complex tasks**: Run an online store, manage bookings, or power a dashboard

## Using both modes together

**Canvas and Preview are built to work together**. You don't have to choose one or the other. You can start with design and evolve into a full app.

<Steps>
  <Step title="Design first">
    Start in Canvas to quickly visualize your idea. Focus on how your app looks and feels—the layout, colors, buttons, and user experience.
  </Step>

  <Step title="Refine and iterate">
    Use **Reimagine** to explore new directions for the selected design, or open the [Visual Editor](/learn/design/visual-editor) to click directly on elements and adjust them. You can also chat with Agent to describe changes you want—they appear immediately.

    <Frame>
      <img src="https://mintcdn.com/replit/NqvyWjOnebeS7HrG/images/replitai/canvas-reimagine.png?fit=max&auto=format&n=NqvyWjOnebeS7HrG&q=85&s=d913949ca41182092608c123828288f0" alt="The Reimagine your design dialog in Canvas, showing recommended prompts such as 'Explore different approaches,' 'Try different layouts,' and 'Explore different vibes.'" width="2216" height="1616" data-path="images/replitai/canvas-reimagine.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/replit/NqvyWjOnebeS7HrG/images/replitai/canvas-visual-editor.png?fit=max&auto=format&n=NqvyWjOnebeS7HrG&q=85&s=401ee84fd5add21fc418c0521ac22c7f" alt="The Visual Editor panel open in Canvas, showing font size, font weight, alignment, and color controls for a selected element." width="2222" height="1572" data-path="images/replitai/canvas-visual-editor.png" />
    </Frame>
  </Step>

  <Step title="Convert to a full app">
    When you're happy with your design and ready to add real functionality, select **Build** to convert your design into an app. You can create a new artifact or apply the design to an existing one. Agent adds the ability to save data, handle user accounts, and connect to services—all while keeping your design intact. See the [Turn a Figma design into an interactive app](/build/figma-to-app) guide for the full workflow.

    <Frame>
      <img src="https://mintcdn.com/replit/NqvyWjOnebeS7HrG/images/replitai/canvas-build-dialog.png?fit=max&auto=format&n=NqvyWjOnebeS7HrG&q=85&s=ca2917d4a7e9650583fbb1ec71cc0ee3" alt="The Build or apply your designs dialog in Canvas, showing options to create a new artifact or apply the design to an existing creation." width="2210" height="1310" data-path="images/replitai/canvas-build-dialog.png" />
    </Frame>

    <Note>
      Agent will prompt you to convert when you try to add a database or advanced features.
    </Note>
  </Step>

  <Step title="Publish and share">
    Once your app is built, publish it so anyone can access it online. Replit handles all the technical infrastructure so your app works reliably for your audience.
  </Step>
</Steps>

## When to use each mode

<CardGroup cols={2}>
  <Card title="Start with Canvas" icon="paintbrush">
    * You want to see your idea quickly
    * You're creating a simple website
    * You want to test different designs
    * Speed is your priority
  </Card>

  <Card title="Go straight to Preview" icon="cube">
    * You know exactly what you need
    * Your app must save data from day one
    * People need to log in
    * You're connecting to other services
  </Card>
</CardGroup>

<Tip>
  **Not sure which to pick?** Start with Canvas. It's faster, and you can always convert to a full app later. Your work is never wasted—it carries over when you upgrade.
</Tip>

## Key differences

| Feature                    | Canvas                      | Preview                            |
| -------------------------- | --------------------------- | ---------------------------------- |
| **Speed**                  | A few minutes               | About 10 minutes for complete apps |
| **Data storage**           | Visual only (no saving)     | Saves and retrieves real data      |
| **User accounts**          | Shows what login looks like | Actual login functionality         |
| **Connecting to services** | Not available               | Payments, emails, external data    |
| **Hosting**                | Simple static hosting       | Scales with your audience          |

## Next steps

<CardGroup cols={2}>
  <Card title="Canvas" icon="paintbrush" href="/learn/design/canvas">
    Learn more about creating designs
  </Card>

  <Card title="Visual Editor" icon="edit" href="/learn/design/visual-editor">
    Make visual changes with clicks
  </Card>

  <Card title="Agent" icon="robot" href="/references/agent/overview">
    Explore what Agent can build for you
  </Card>

  <Card title="Learn" icon="graduation-cap" href="https://learn.replit.com">
    Learn the complete workflow
  </Card>
</CardGroup>
