Your First Repository
Start working on a Repository by importing an existing repository from GitHub or creating from a template.
Importing a Repository
-
Go to the Dashboard.
-
From the left sidebar, click on the team (personal or another) you want to import your project into. You can create new teams right from this menu.
-
Click on the
Create
button, in the top right corner. -
Select
Import from GitHub
-
Enter a valid GitHub URL or choose a repository from the pre-loaded repository list.
For valid GitHub URLs, follow this format:
https://
github.com/
:org/
:repo
- Include the protocol, such as
https
; - Don't include branch name;
- For example,
https://github.com/facebook/react
.
-
If the search does not return any matches, click on the
Show all
button under the last repository visible in the list to load more repositories. -
If not all your GitHub organizations are listed in the dropdown, click on
Manage GitHub integrations
to grant the required permissions.
- Click on Import.
Troubleshooting
Permission errors while importing a project
-
Verify your team's permission to open CodeSandbox Repositories.
-
Verify your repository permissions on GitHub. You need to have
write
permission on GitHub to be able to import the project. Repositories where you only haveread
access can only be forked. -
Verify your GitHub permissions. CodeSandbox requires full git access to be able to import and commit. If you face any authentication errors, follow the steps to reset your GitHub permissions listed below.
Resetting GitHub permissions
-
Go to the Dashboard.
-
Click on the Menu icon at the top right of the screen.
-
Click on Preferences.
-
Go to Integrations.
-
Sign out from GitHub and sign in again to reconnect your GitHub account.
Invalid authorization code on Firefox and Safari
Safari and Firefox block popups by default. Please make sure you give the domain permission (through the browser settings) or refresh the page after you opened the popup and try again.