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

# Import from GitHub

> Bring an existing GitHub project into CatDoes and let AI turn it into a mobile app.

Already have a project on GitHub? You can import it directly into CatDoes instead of starting from scratch. This is a great way to bring in projects from tools like Lovable, Bolt, or any codebase you already have on GitHub.

<Note>
  Importing from GitHub requires a Plus plan or above.
</Note>

## How to Import

1. Go to [app.catdoes.com](https://app.catdoes.com/dashboard) and click **New Project**.
2. In the dialog, click **Import from GitHub**.
3. You'll be taken to GitHub to authorize CatDoes. Choose which repositories you want to give CatDoes access to, then confirm.
4. Once you're redirected back to CatDoes, the import form opens automatically.
5. Select your **repository** from the dropdown.
6. Choose the **branch** you want to import (your default branch is selected automatically).
7. Give your project a **name** — it's auto-filled from your repository name, but you can change it.
8. Choose your project visibility:
   * **Public** — anyone can see your project. Free to create.
   * **Private** — only you and your team can see it. Requires an active subscription.
9. Click **Import**.

CatDoes will pull in your code and set everything up. Once it's done, you're taken straight to your new project, ready to start working with the AI agents.

## When to Use This

* You built something with **Lovable**, **Bolt**, or another tool and want to turn it into a native mobile app
* You already have a codebase on GitHub and want AI agents to work with it
* Your project has pages behind a login that CatDoes can't access by visiting the URL directly — importing the code gives the agent full access to everything

## Tips

<Tip>
  If your project isn't on GitHub yet, most tools (like Lovable) let you connect to GitHub with a few clicks. Once your code is pushed there, you can import it into CatDoes.
</Tip>

<Tip>
  After importing, your project is linked to the GitHub repository. You can manage the connection from your project dashboard — see [GitHub Integration](/features/github-integration) for details.
</Tip>
