Running GitHub repositories on Replit
Learn how to import, configure, and run GitHub repositories on Replit, including setting up run commands and adding “Run on Replit” badges to your projects.
GitHub repositories can be run automatically on Replit. Head to https://replit.com/github to import a repository. You can unlock private repositories after authenticating with GitHub and purchasing the Replit Core membership.
From the modal above, you can select the repo, language, and owner of the Replit App. We will automatically detect the language if your GitHub repository already has a .replit file!
Configuring a Cloned Repo
When you clone a repository without a .replit file, we automatically show the visual .replit editor:
This will automatically create the .replit file and make it possible to customize how the Replit App will run.
You can use the shell to run any command and then set the “Run” button once you’ve decided what it should do.
Clicking “done” will finalize the Replit App’s configuration and close the visual editor.
Adding a .replit file to a repository makes cloning fast with no configuration necessary. The configuration file can always be changed at any time. For more information on how to configure your Replit App, see the documentation on Configuring your Replit App.
Adding a “Run on Replit” Badge
After configuring a run command for your Replit App, you can add a badge to your repository README that will allow anyone to run your project automatically!