• Documentation
  • Getting Started
  • Your First Repository

Your First Repository

Start working on a Repository by importing an existing repository from GitHub or creating from a template.

Your First Project

Importing a Repository

  1. Go to the Dashboard.

  2. 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.

  3. Click on the Create button, in the top right corner.

  4. Select Import from GitHub

  5. 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.

  1. 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 have read 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

  1. Go to the Dashboard.

  2. Click on the Menu icon at the top right of the screen.

  3. Click on Preferences.

Preferences Dropdown Menu Point on CodeSandbox Dashboard

  1. Go to Integrations.

  2. 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.