Create a new Astro project with Gitpod
Although you can open any of Astro’s official starter templates in a few different cloud environments at astro.new, the best way to get started with a new Astro project in Gitpod is to start from an existing repository of your own.
Use the instructions below every time you want to make a new Astro (or Starlight) website!
Create a repository
- Create a new, blank repository on GitHub, GitLab or BitBucket. Do not add any files when creating this repo, such as a README or a
.gitignore. You will need a blank repository with no existing content.
Open your repository in Gitpod
- Open that new repository in Gitpod using one of the following methods:
Run the Astro CLI wizard
When your repository finishes opening in Gitpod’s editor, launch the Astro CLI wizard in the terminal with the following command.This will guide you through setting up a new project.
Follow the instructions and when asked where to install the project, type
./(Do not add a folder name. This will create your project at the root of your repository.)
The final set of instructions will tell you to how start the dev server with the command
npm run dev. Your workspace is now ready for coding!
(Optional) Add a
.gitpod.ymlfile to the root of your project to automatically run commands every time you re-open your Astro project. My file installs dependencies, starts the dev server and opens a preview of my site in another browser tab every time my project launches:
Commit and publish your changes
After working on your site, you can commit your changes to local version control, and eventually back to your source repository (or throw them away!) via the Source Control menu item in the left navigation. The first time you commit back to your online repository, you will need to type the following commands manually into the terminal.
Any subsequent commits can be done using the Source Control commit button, which will then become a “publish” button in order to sent your changes back to your online repository. Both steps are necessary to update your project at GitHub or GitLab.
Any changes you make are saved to this “Workspace” which is a particular instance of your repository. This workspace will save its own state, even between starting/stopping the workspace, but will only push back to your online source code when you choose to commit and sync.
Edit your existing project
To revisit your project and work on this exact version of your code, re-open the workspace from your Gitpod dashboard. To go back and start fresh from source again, re-open your repository from one of the two earlier methods.
If you don’t like what you did in a particular workspace, then just delete (or ignore) the workspace! Unused workspaces will automatically delete after 14 days of inactivity via Gitpod’s Garbage Collection. You can have multiple workspaces editing the same source project at the same time. They are completely independent of each other.