Replit’s import feature allows you to transform existing projects and designs from external development and design tools into Replit Agent Apps. This reference covers supported platforms, technical specifications, limitations, and compatibility requirements.

​
Supported import sources

Replit’s import feature supports the following external platforms:

  • Figma: Convert design frames into React applications using AI-powered code generation
  • Bolt: Import existing Bolt projects and migrate them to Replit Agent Apps
  • Lovable: Transfer Lovable projects to Replit with Agent assistance
  • Replit Agent: Import previously exported Agent Apps from GitHub repositories
  • GitHub: Import compatible repositories as Agent Apps

All imported projects are validated for Agent compatibility before conversion begins.

​
Quickstart guides

For step-by-step instructions to import from each platform, see our quickstart guides:

Import from GitHub

⏱️ 2 minutes

Import an existing GitHub repository into Replit.

Import from Figma

⏱️ 3 minutes

Convert your Figma designs into functional React applications.

Import from Bolt

⏱️ 4 minutes

Migrate your Bolt projects to Replit with Agent assistance.

Import from Lovable

⏱️ 4 minutes

Transfer your Lovable projects to Replit and continue building.

​
Features

  • Automatic compatibility validation: Ensures imported projects work with Replit Agent
  • AI-powered migration: Agent assists with project setup and feature completion
  • Design-to-code conversion: Transform Figma designs into functional React applications
  • Enterprise-ready templates: Import customized Agent Apps with internal configurations
  • Real-time progress tracking: Monitor import status with detailed progress updates

​
Usage

​
Accessing the import feature

  1. Navigate to replit.com/import
  2. Select your desired import source from the available options
  3. Follow the platform-specific import workflow

​
Import workflow

The import process follows these general steps:

​
Platform-specific workflows

​
Limitations and considerations

​
Current limitations

  • Database data: Database contents are not imported; only schemas and edge functions are included
  • Complex dependencies: Some complex or proprietary dependencies may require manual configuration
  • Large projects: Very large projects may take longer to process or require optimization

​
Future enhancements

  • Database content migration: Full database content import capabilities
  • Enhanced validation: Improved compatibility checking for complex projects

​
Error handling

If an import fails, you’ll receive specific error messages indicating the issue:

  • Compatibility errors: The project structure is incompatible with Agent
  • Access errors: Unable to access the source project or repository
  • Processing errors: Technical issues during conversion

If you encounter persistent import issues, check that your source project is publicly accessible or that you have proper permissions.

​
Best practices

​
Preparing for import

  • Clean project structure: Ensure your source project has a clear, organized structure
  • Remove sensitive data: Remove API keys, credentials, and sensitive information before import
  • Document dependencies: Include clear documentation of external dependencies
  • Test functionality: Verify your source project works correctly before importing

​
After import

  • Review generated code: Check the imported code for accuracy and completeness
  • Test functionality: Thoroughly test all features in the Replit environment
  • Check secrets: Agent will help you add secrets, but be sure to double check them and add any missing ones using Replit’s Secret management.
  • Recreate databases: If your project uses databases, recreate them using the Database tool or by asking Agent to help you.

​
Billing

Import processing may consume Agent credits depending on the complexity of the migration and Agent involvement.

Imports that require Agent assistance for migration or setup will consume credits based on the amount of processing required. Simple imports may complete without additional charges beyond your standard Replit usage.

​
Troubleshooting

​
Common issues

Import validation fails

  • Verify your source project uses supported frameworks and technologies
  • Check that all required files are present and accessible
  • Ensure your project follows standard conventions for your platform

Import takes too long

  • Large or complex projects may require extended processing time
  • Monitor the progress screen for status updates
  • Contact support if processing exceeds expected timeframes

Generated code doesn’t work as expected

  • Review the imported code for missing dependencies or configurations
  • Use Agent to help debug and resolve any issues
  • Check that all external services and APIs are properly configured

For additional support, visit the Replit Help Center or contact our support team.