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

# Previewing your local app

> See your running app inside Subframe.

<Note>
  The features in this guide are only available in the Subframe desktop app. [Download the desktop app for macOS
  ↗](https://subframe.com/downloads).
</Note>

Open your app in a browser tab to start [editing it live](/browser/making-live-edits) or [capturing it as a design](/browser/capturing-as-designs).

<Steps>
  <Step title="Connect your codebase">
    Open a new browser tab, click **Connect codebase**, then select your local repository.

    You can also [connect your codebase from Agent chat](/agent/connecting-your-codebase).
  </Step>

  <Step title="Start your dev server">
    Click **Start server**. Your [agent](/agent/overview) starts the dev server and opens your app.
  </Step>
</Steps>

If your server is already running, click its port under **Detected servers**.

## Opening any URL

Enter a URL such as `localhost:3000` in the address bar, then press <kbd>Enter</kbd>.


## Related topics

- [Previewing designs](/learn/design-mode/preview.md)
- [Desktop app](/desktop-app.md)
- [Connecting your codebase](/agent/connecting-your-codebase.md)