Step 1: Push Your Replit Project to GitHub
Replit has built-in Git and GitHub integration:Open the Version Control panel
Click the Git icon in the left sidebar (or go to Tools > Git) to open the version control panel.
Connect to GitHub
Click Connect to GitHub. If prompted, authorize Replit to access your GitHub account. Create a new repository or connect to an existing one.
Replit projects may include Replit-specific configuration files (
.replit, replit.nix). These won’t cause problems in Workshop — the agent will focus on the standard project files and package manager configuration.Step 2: Connect GitHub in Workshop
If you haven’t already connected your GitHub account to Workshop:- Workshop Desktop
- Workshop Cloud
- Open Workshop Desktop and navigate to Hub > Connectors
- Click Connect on the GitHub connector
- Authorize the Workshop GitHub App and select which repositories to grant access to
- Confirm the connection
Step 3: Create a Project from Your Replit Repository
- Workshop Desktop (Recommended)
- Workshop Cloud
- Click New Project from the Projects page
- Select Import from Git
- Choose your Replit repository from the list, or paste the repository URL
- Workshop clones the repository and creates your project
Step 4: Set Up and Run Your Project
Once the project is created, open a conversation and ask the agent to get your project running:- Detect the language and framework (Node.js, Python, or whatever your Repl uses)
- Install dependencies using the appropriate package manager
- Start the development server
- Ignore Replit-specific config files that aren’t needed locally
What You Can Do Next
With your Replit project now in Workshop, you can extend it beyond Replit’s capabilities:| Capability | Example Prompt |
|---|---|
| Add AI models | ”Add Claude and Gemini support for multi-model AI features” |
| Connect databases | ”Set up a PostgreSQL database to replace the SQLite file” |
| Build a backend | ”Add a FastAPI backend with proper authentication” |
| Local models | ”Configure a local LLM so I can develop with AI features offline” |
| Custom deployment | ”Help me deploy this to Railway with a PostgreSQL database” |
Deployment
Workshop’s one-click publish is designed for projects built natively in Workshop. For your imported Replit project, ask the agent to set up deployment:Ready to get started?
Download Workshop Desktop to import your Replit project with the best experience.