Documentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
Import lets you bring existing code or designs into Replit Apps and continue building with Agent.
Supported sources
| Source | What you provide | Best for |
|---|
| GitHub | Repository URL or repository picker | Public and private repository imports |
| Bitbucket | Repository URL or repository picker | Bitbucket-hosted repository imports |
| Vercel | GitHub repository behind your Vercel project | Migrating Vercel apps |
| Figma | Frame URL | Turning designs into React apps |
| Bolt | GitHub repository exported from Bolt | Migrating Bolt projects |
| Lovable | GitHub repository exported from Lovable | Migrating Lovable projects |
| Base44 | GitHub repository exported from Base44 | Migrating Base44 projects |
| ZIP | .zip file upload | Importing local project archives |
| Spreadsheet | .xlsx, .csv file, or Google Sheets URL | Building an app from spreadsheet data |
| Previous Agent export | GitHub repository exported from a previous Agent App | Re-importing a previous Agent App |
| Empty | Nothing | Power users who want a blank project without Agent |
Replit validates compatibility before import starts.
For Figma designs, see Turn a Figma design into an interactive app.
Quick imports
Pick a source for step-by-step instructions:
Lovable
Base44
Vercel
Bolt
GitHub
ZIP
⏰ Estimated time: four minutesImport a Lovable project into Replit by exporting it to GitHub, then importing that repository.Before you start
- A Lovable project you can export
- A GitHub account connected to Lovable
- A Replit account
Steps
- Export your Lovable project to GitHub.
- Open replit.com/import.
- Select Lovable.
- Connect your GitHub account.
- Select the exported Lovable repository.
- Select Import.
What gets imported
Replit imports the following from your project:
- Code: Application logic and source files
- Design and styles: UI components and styling rules
- Assets: Images, icons, and static files
- Backend logic: Server-side functionality, if present
- Database schema: Table structure, if present
What is not imported
- Supabase data: Existing database records are not migrated
- Secrets: Environment variables and API keys must be added separately
Use Agent to rebuild missing functionality, add secrets, and recreate database data.During import, . If your app needs changes, use these Project Editor tools:
- Agent: Refine features, debug issues, and make code changes
- Secrets: Add API keys and environment variables
- Workflows: Set the Run command for your app
Continue your journey
Now that you’ve imported your , explore these next steps: ⏰ Estimated time: four minutesImport a Base44 project into Replit by exporting it to GitHub, then importing that repository.Before you start
- A Base44 project you can export
- A GitHub account connected to Base44
- A Replit account
Steps
- Export your Base44 project to GitHub.
- Open replit.com/import.
- Select Base44.
- Connect your GitHub account.
- Select the exported Base44 repository.
- Select Import.
What gets imported
Replit imports the following from your project:
- Code: Application logic and source files
- Design and styles: UI components and styling rules
- Assets: Images, icons, and static files
- Backend logic: Server-side functionality, if present
- Database schema: Table structure, if present
What is not imported
- Supabase data: Existing database records are not migrated
- Secrets: Environment variables and API keys must be added separately
Use Agent to rebuild missing functionality, add secrets, and recreate database data.During import, . If your app needs changes, use these Project Editor tools:
- Agent: Refine features, debug issues, and make code changes
- Secrets: Add API keys and environment variables
- Workflows: Set the Run command for your app
Continue your journey
Now that you’ve imported your , explore these next steps: ⏰ Estimated time: three minutesImport a Vercel project into Replit by linking the GitHub repository behind the project.Before you start
- A Vercel project connected to GitHub
- Access to the backing GitHub repository
- A Replit account
Steps
- Open replit.com/import.
- Select Vercel.
- Connect your GitHub account.
- Select the repository for your Vercel project.
- Add any requested secrets and environment variables.
- Select Import.
What gets imported
- Project files and directory structure
- Dependency and framework configuration
- Run and build defaults for Replit
What is not imported
- Existing environment variable values
- Custom domains
- Vercel-specific edge or middleware behavior
- External analytics or monitoring configuration
During import, . If your app needs changes, use these Project Editor tools:
- Agent: Refine features, debug issues, and make code changes
- Secrets: Add API keys and environment variables
- Workflows: Set the Run command for your app
Continue your journey
Now that you’ve imported your , explore these next steps: ⏰ Estimated time: four minutesAgent currently supports Bolt imports for Vite + React apps.
Import a Bolt project into Replit by exporting it to GitHub, then importing that repository.Before you start
- A Bolt project you can export
- A GitHub account connected to Bolt
- A Replit account
Steps
- Export your Bolt project to GitHub.
- Open replit.com/import.
- Select Bolt.
- Connect your GitHub account.
- Select the exported Bolt repository.
- Select Import.
What gets imported
Replit imports the following from your project:
- Code: Application logic and source files
- Design and styles: UI components and styling rules
- Assets: Images, icons, and static files
- Backend logic: Server-side functionality, if present
- Database schema: Table structure, if present
What is not imported
- Supabase data: Existing database records are not migrated
- Secrets: Environment variables and API keys must be added separately
Use Agent to rebuild missing functionality, add secrets, and recreate database data.During import, . If your app needs changes, use these Project Editor tools:
- Agent: Refine features, debug issues, and make code changes
- Secrets: Add API keys and environment variables
- Workflows: Set the Run command for your app
Continue your journey
Now that you’ve imported your , explore these next steps: ⏰ Estimated time: two minutesImport a GitHub repository into Replit to run, test, and publish faster.Before you start
- A GitHub repository URL
- Access to the repository (public or private)
- A Replit account
Option one: rapid importRapid import works for public repositories.
- Copy the repository path after
github.com/.
- Open
https://replit.com/github.com/<owner>/<repo>.
- Press Enter to start import.
Example
- GitHub URL:
https://github.com/exampleUser/my-app
- Replit import URL:
https://replit.com/github.com/exampleUser/my-app
Option two: guided importGuided import supports public and private repositories.
- Open replit.com/import.
- Select GitHub.
- Connect your GitHub account.
- Choose a repository.
- Select Import.
What gets imported
- Repository files and folders
- Dependency files
- Common run and build configuration
What is not imported
- Existing secret values and environment variable values
- Platform-specific services that do not run in Replit by default
During import, . If your app needs changes, use these Project Editor tools:
- Agent: Refine features, debug issues, and make code changes
- Secrets: Add API keys and environment variables
- Workflows: Set the Run command for your app
Continue your journey
Now that you’ve imported your , explore these next steps:Troubleshooting GitHub connection issuesIf you see Failed to get repository, please re-authenticate with GitHub, or the repository dropdown shows No repositories found, the GitHub import flow uses a separate connection from the one in your Account → Connected Services page. Reconnecting under Connected Services alone will not fix the import flow.Reconnect GitHub from Git Providers
Open the Git Providers section in your Replit account settings, disconnect GitHub, and reconnect from the same screen. After this, your personal repositories should appear in the import dropdown.
Approve the Replit app for your GitHub organization
If the repository is owned by a GitHub organization, open https://github.com/settings/applications, find the Replit OAuth app, and grant it access to the organization under the third-party application access settings. Organization admins may need to perform this step if you are not an org owner. Retry the import
Open replit.com/import and try the import again, both from the repository dropdown and by pasting the repository URL. ⏰ Estimated time: three minutesImport a local project by uploading a .zip file.Before you start
- A
.zip file that contains your project
- A clear project root folder in the archive
- A Replit account
Steps
- Open replit.com/import.
- Select ZIP.
- Upload your
.zip file.
- Add any requested secrets and environment variables.
- Select Import.
What gets imported
- Project files and directory structure
- Dependency files
- Run and build defaults for Replit
What is not imported
- Existing environment variable values
- Custom domains
- Platform-specific services that need manual setup
- Existing database data
- Existing third-party connector configuration
During import, . If your app needs changes, use these Project Editor tools:
- Agent: Refine features, debug issues, and make code changes
- Secrets: Add API keys and environment variables
- Workflows: Set the Run command for your app
Continue your journey
Now that you’ve imported your , explore these next steps:
Other sources
Bitbucket
- Paste a Bitbucket repository URL, or connect your Bitbucket account to search your repositories.
- Agent support during the import may be limited compared to GitHub-hosted projects.
Spreadsheet
- Upload an Excel (
.xlsx) or CSV file, or paste a public Google Sheets URL.
- Agent reads your spreadsheet structure and builds a full-stack app with a database seeded from your data.
- Includes a UI to view, search, and manage your records.
Previous Agent export
- Re-import a previously exported Agent App from a GitHub repository.
- Replit preserves Agent-specific structure (code, database schema, backend functionality).
- Database values and secret values are not imported.
Empty
- Start with a completely empty project — no Agent, no framework selection, and no scaffolding.
- Best for power users who want full control over project setup.
Limitations
- Existing database data is not migrated.
- Some complex or proprietary dependencies may need manual setup.
- Large projects can take longer to process.
Best practices
- Remove sensitive credentials before import.
- Keep your source project structure clean.
- Verify dependencies and run commands after import.
- Test core flows before publishing.
Troubleshooting
If import fails, check these areas first:
- Compatibility errors: Verify required project files and supported frameworks.
- Access errors: Confirm repository or source permissions.
- Processing errors: Retry after simplifying project structure or reducing size.
If issues continue, visit the Replit Community Hub or contact Support.
Billing
Imports that require Agent migration work can consume credits. Credit usage depends on project complexity.