Skip to main content

Import your ZIP project

Estimated time: three minutes You can import your projects into Replit by uploading a ZIP file containing your codebase. Agent scans your code and handles the setup automatically. This quickstart covers the step-by-step process to import your ZIP-compressed projects to Replit with a clean workflow, live preview, and logs. For comprehensive import options including other platforms like GitHub, Figma, Bolt, Lovable, and Vercel, see the Import feature documentation.
Preview of ZIP project import in Replit

Import process

  1. Navigate to https://replit.com/import.
Replit import interface showing available sources
  1. Select ZIP from the available import sources.
  2. Upload your ZIP file containing your project files.
  3. Provide environment variables when prompted by Agent. Only non-standard secrets and environment variables will be requested.
  4. Select Import to start the migration process.

What gets imported

During the import process, Replit extracts and converts your ZIP file into a functional Replit App:
  • Project structure: Complete codebase and file organization
  • Dependencies: Package files and dependency management
  • Build configuration: Optimized for Replit’s environment
  • Environment setup: Runtime and framework configuration

What’s not included

The following items from your ZIP file are not automatically imported:
  • Environment variables: You’ll be prompted to provide these during import
  • Custom domains: Set up separately in Replit Deployments
  • Platform-specific configurations: Some configurations may need adjustment
  • Analytics and monitoring: Use Replit’s built-in monitoring tools

Configure and run your app

During the import process, . If your app doesn’t run as expected, Replit offers the following workspace tools to help you resolve the issues:
  • Agent: Use AI to add new features and refine your imported project
  • Assistant: Get help with code questions and debugging
  • Secrets: Add your API keys and environment variables
  • Workflows: Configure the Run button to your preferred command

Continue your journey

Now that you’ve imported your , learn more about what you can do with your Replit App: