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

# See your Lovable project as a map

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

## Step 1: Get your Lovable project on GitHub

In Lovable, open **Settings** → **Git** → **GitHub**, click **Add connection** and **Add account**, then **Install & Authorize** on GitHub. Back in your project's **Settings** → **Git** → **GitHub**, click **Connect**: Lovable creates a private repo and keeps it in sync both ways ([Lovable and GitHub](https://docs.lovable.dev/integrations/github)).

## Step 2: Connect that repo to SeeRepo

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

Lovable's commits are authored by `lovable-dev[bot]`, which SeeRepo recognizes as Lovable because of the word "lovable". Lovable notes that a raw git log can show the account's older name, `gpt-engineer-app[bot]`: SeeRepo recognizes that one as Lovable too.

## Step 3: Copy a prompt from Health into Lovable'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 Lovable's chat. See [Health](/docs/health) for every kind of task.

## Step 4: Check the change on your map

Lovable pushes each 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
- Lovable works on one branch at a time: SeeRepo reads the repo's default branch, and one more if you follow it ([Follow a second branch](/docs/connect-a-repo#follow-a-second-branch))