Source: https://seerepo.com/docs/bolt
Markdown source: https://seerepo.com/docs/bolt.md
Description: Get your Bolt project on GitHub, connect it to SeeRepo, and hand Bolt a prompt from Health.

# See your Bolt project as a map

Bolt builds your app in the browser through prompts. Since you don't write the code yourself, SeeRepo shows you what Bolt built and how its parts connect.

## Step 1: Get your Bolt project on GitHub

In Bolt, click the GitHub icon at the top right, **Log in to GitHub** and **Install the GitHub App** with **Install & Authorize**. Then open the GitHub icon again, name the repo and click **Create repository**: it's created private, on `main`. Bolt commits each change that doesn't break the project and checks GitHub every 30 seconds for changes made elsewhere ([Bolt and Git](https://support.bolt.new/integrations/git)).

## Step 2: Connect that repo to SeeRepo

Sign in to SeeRepo with GitHub, give the SeeRepo GitHub App access to the repo Bolt created, choose it under "**Which repo do you want to see?**" and click "**Draw my project**". See [Connect a repo](/docs/connect-a-repo).

SeeRepo recognizes a commit as Bolt's when its author or its Co-Authored-By line says `bolt.new` or `stackblitz`. Bolt doesn't document the author of its commits, so they may count as yours.

## Step 3: Copy a prompt from Health into Bolt's chat

Open **Health** in SeeRepo, tap a task and, in its sheet, click "**Copy prompt**". Here is a real one, with example file names:

```text
In my project your-name/your-repo, no file of the product imports these files:
- src/old/Banner.tsx
- src/utils/legacyFormat.ts

Check each one (look for dynamic or convention-based uses too) and delete the ones that are really unused, with their tests. Tell me what you deleted and what you kept, and why.
```

Paste it into Bolt's chat. See [Health](/docs/health) for every kind of task.

## Step 4: Check the change on your map

Bolt commits the change to GitHub, and SeeRepo reads every push. The module it touched says when it changed. See [Where the work is happening](/docs/heat-and-recent-changes).

## Troubleshooting

Common problems:

- The repo isn't on GitHub yet: finish Step 1 first
- The SeeRepo GitHub App wasn't given access to that repo
- If Bolt and GitHub change at the same time, Bolt's version wins ([Bolt and Git](https://support.bolt.new/integrations/git))