Import a Git project to the Astro IDE
Public Preview
This feature is in Public Preview.Import an existing Git-based project from your preferred provider into the Astro IDE.
You can’t deploy code directly to an Astro Deployment from projects imported with a manual Git provider configuration. To deploy, commit and push your changes back to your Git provider, then trigger your usual CI/CD deployment process. Direct deploy from the IDE is only supported for projects imported with the Astro GitHub integration, the Astro CLI, or projects created in the IDE. See Deploy code from the Astro IDE.
Import a Git project
To import a GitHub project using the Astro GitHub integration, see the GitHub import guide.
Prerequisites
- Workspace Author permissions.
- A remote Git repository containing an Astro project.
- Access permissions to the repository.
- Project size under 200MB and individual file sizes under 1MB. See Project requirements.
Configure manual Git provider connection
-
Select your Git provider: GitHub, GitLab, Bitbucket, Azure Repos, or Generic.
-
Fill in the following fields:
- Account: The organization or user as shown in the provider URL.
- Repository/Project: The repository or project name.
- Astro Project Path: The subdirectory where your Astro project is located, if not at repository root.
- Branch: The branch to use. Defaults to the provider’s default branch.
-
Select authentication type. Available authentication types may differ slightly for each Git provider:
- Basic
- Personal access token
- Deploy key or Personal SSH key
- None (public repository): Select if you are connecting to a public repository that does not require authentication. You can’t push changes to the remote repository without authentication.
Click Connect to begin importing.
Start a new session with your imported project
After importing your project, you can start a new session with it.
Prerequisites
You need to have an imported project in the Astro IDE. Follow the steps in Import a Git project to import a Git project if you haven’t already.
Resume a previous session
Once you have created a session with your imported project, you can close it, and later resume it. In the Astro IDE, go to the Sessions tab, and click the session you want to resume.
