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.
Deploying code directly to an Astro Deployment is not available for projects imported via manual Git provider configuration. To deploy, you must 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 from projects imported via Astro GitHub integration, the Astro CLI, or a project created in the IDE. See Deploy code from the Astro IDE for more information.
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.
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 cannot push changes to the remote repository without authentication.
Click Connect to begin importing.
