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

# GitHub Import And Export

> Bring an existing repo into Rushed or send your work back to GitHub when you are ready.

## Import from GitHub

Import creates a new Rushed project from an existing repository URL.

Use it when you want to:

* redesign an existing app
* add a feature to a live codebase
* clean up structure without cloning locally first

### What to expect

1. Open `Import`.
2. Paste a GitHub repository URL.
3. Rushed creates a new project and starts pulling the files in.
4. Open the project and begin chatting against the imported codebase.

## Export to GitHub

Export creates a repository from your current Rushed project.

You choose:

* repository name
* visibility
* optional description

Once export completes, Rushed gives you a direct GitHub link.

## Plan requirements

GitHub import and export are gated behind paid access in the current product flow. If you try to use them without the required plan or connection, Rushed will prompt you to upgrade or connect GitHub first.

## Best ways to use GitHub with Rushed

### Bring a real app in

Import a working repo, then ask for:

* a cleaner landing page
* a new dashboard view
* mobile fixes
* a design refresh

### Prototype first, export later

Start from a prompt, shape the product until it feels right, then export when you want a repository to take over manually.

## Tips

* If the imported project does not preview correctly, set the install and start commands in Preview settings.
* Keep requests grounded with `@` file references after import.
* Export is best once the project direction is stable, not after every minor change.