# Preview



Preview renders the front end of the app you are building in real time. It runs inside a live sandbox environment and updates as you make changes. Several controls in the top navigation bar let you navigate, share, and configure the preview.

## Navigation Bar [#navigation-bar]

## Address Bar & Port [#address-bar--port]

The address bar displays the relative path of the current page in your app. The port selector lets you switch between any port running in the sandbox — useful when your project runs multiple services (e.g., frontend on 3000, API on 8000).

### Copy Preview URL [#copy-preview-url]

Copies the sandbox URL of your project. Paste it into any browser to view your app outside of Ideavo.

<Callout type="warn">
  This is a temporary link. It stays active only while Ideavo is open — a
  continuous heartbeat keeps the sandbox alive. Once you close the platform, the
  link expires immediately. Use it for quick sharing during development, not for
  publishing.
</Callout>

### Open in New Tab [#open-in-new-tab]

Opens the same sandbox preview in a new browser tab without copy-pasting. Behavior is identical — the link expires when the platform closes.

### Home [#home]

For multi-page applications, the Home button returns you to the main page of your app.

## Device Preview [#device-preview]

The device preview lets you see how your app renders on different screen sizes without leaving Ideavo.

<Steps>
  <Step>
    Switch to the 

    **Preview**

     tab in your project.
  </Step>

  <Step>
    Click the 

    **device icon**

     in the top-right of the preview area.
  </Step>

  <Step>
    Choose **Desktop** for full-width preview, or **Mobile** to enable the
    device frame and preset dropdown.
  </Step>

  <Step>
    Pick a device preset to set a specific width and height (Mobile only).
  </Step>
</Steps>

Mobile presets cover popular iPhone and Android sizes — helping you validate responsive breakpoints, fonts, and tap targets before shipping.

<Callout type="info">
  Preview is for testing only. For a permanent deployment with a shareable URL,
  use the [Publish](/docs/features/publish) feature.
</Callout>

## Restart Dev Server [#restart-dev-server]

<DocImage src="features/preview/restart-dev-server" alt="The refresh button in the preview toolbar, with its Restart Dev Server tooltip" width="922" height="210" />

The **Restart Dev Server** button re-initializes your local development environment. It stops and restarts the active dev server, clears temporary caches, and reloads configuration — ensuring the preview reflects your latest changes when automatic hot reload fails.

### When to Use It [#when-to-use-it]

* Preview hangs, doesn't load, or shows stale data
* After switching frameworks or changing environment variables
* As the first troubleshooting step for unexpected preview behavior

<Callout type="info">
  Restarting the dev server does not affect your code — it only refreshes the
  runtime environment.
</Callout>

### FAQ [#faq]

<Accordions>
  <Accordion title="Why does my preview URL stop working?">
    The sandbox URL is tied to an active session. Once you close Ideavo, the
    heartbeat stops and the link expires. Reopen the project to get a new active
    URL, or use the Publish feature for a permanent link.
  </Accordion>

  <Accordion title="Can I preview on a port other than the default?">
    Yes. Use the port selector in the address bar to switch to any port running
    in your sandbox. This is useful for projects with separate frontend and
    backend services.
  </Accordion>

  <Accordion title="My preview isn't reflecting my latest changes — what should I do?">
    Try the **Restart Dev Server** button. This clears caches and reinitializes
    the dev server, which resolves most cases where hot reload fails to pick up
    changes.
  </Accordion>
</Accordions>
