Import from GitHub
Learn how to create a Replit App from your GitHub repository code.
Import your GitHub repository
⏰ Estimated time: 2 minutes
You can import your GitHub repositories and turn them into Replit Apps to run, test, and deploy your code.
Import your GitHub repository using one of the following methods:
- Deep linking: add a public GitHub repository to a Replit URL to start the import
- Guided import: Enter the repository details from the Replit home screen
Log into Replit and follow the steps in one of the import methods in the following sections.
Deep linking
Deep linking works instantly with public repositories. Combine the Replit import URL with your GitHub repository URL to start the import process.
-
Copy the repository GitHub URL, starting with
github.com
. -
Type
https://replit.new/
in the browser address bar and paste your copied GitHub URL at the end (no spaces).Example:
GitHub repository URL:
https://github.com/exampleUser/my-app
Import URL:
https://replit.new/github.com/exampleUser/my-app
-
Press Enter to start the automatic import process.
Guided import
Guided import steps you through the process of selecting a repository to import and supports public and private repositories.
Configure and run your app
During the import process, Replit attempts to set your app’s language, dependencies, and workflow. If your app doesn’t run as expected, Replit offers the following workspace tools to help you resolve the issues:
- Agent: Diagnose and fix setup issues using AI-powered assistance.
- Configure Repl: Configure your app’s language, dependencies, and workflow.
- Secrets: Securely add environment variables your app depends on.
Continue your journey
Now that you’ve set up your app, learn more about what you can do with your Replit App from the following resources:
- Private & Personal Repositories: Set up access to private repositories
- Make your Replit App Public: Share your Replit App as a Template for others to remix
- Replit Deployments: Publish your Replit App to the cloud with a few clicks
- “Run on Replit” badge: Add a badge for your GitHub repository
README.md
file that lets others import your repository with one click - Secrets: Securely store sensitive information, including API keys and database credentials