The easiest way to try Astro is to run
npm init astro in a new directory on your machine. Our CLI wizard will assist you in starting a new Astro project.
To get started with Astro in 5 quick and easy steps, visit our Quick-Start guide.
Alternatively, read our Installation Guide for a full walk-through on getting set up with Astro.
If you prefer to learn Astro by example, check out our complete library of examples on GitHub.
You can check out any of these examples on your local machine by running
npm init astro with the
--template CLI flag. The
--template flag also supports third-party, community templates.
# Run the init wizard and use this official template npm init astro -- --template [OFFICIAL_EXAMPLE_NAME] # Run the init wizard and use this community template npm init astro -- --template [GITHUB_USER]/[REPO_NAME] npm init astro -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example
If you’re interested in playing around with Astro in the browser, you can instantly spin up a new Astro project with our UI at astro.new.
You can try Astro in online code editors like Stackblitz, CodeSandbox, Gitpod, and GitHub Codespaces. Click the “Open in Stackblitz” link in any of the examples in our examples library. Or, click here to start a new project in Stackblitz.
All manner of people come to Astro from different backgrounds bringing with them different learning styles. Whether you prefer a more theoretical or a practical approach, we hope you’ll find this section helpful.
- If you prefer to learn by doing, start with our examples library.
- If you prefer to learn concepts step by step, start with our basic concepts and guides.
Like any unfamiliar technology, Astro comes with a slight learning curve. However, with practice and some patience, we know, you will get the hang of it, in no time.
When you begin to learn Astro, you’ll see many files using the
.astro file extension. This is Astro’s Component Syntax: a special HTML-like file format which Astro uses for templating. It was designed to feel familiar to anyone with HTML or JSX experience.
Our helpful guide on Astro components introduces you to the Astro syntax, and is the best way to learn.
This documentation section is useful when you want to learn more details about a particular Astro API. For example, Configuration Reference lists all possible configuration options available to you. Built-in Components Reference lists all available core components, like
<Markdown /> and
This documentation always reflects the latest stable version of Astro. Once we hit the v1.0 milestone, we will add the ability to view versioned documentation.
The @astrodotbuild Twitter account is the official source for the updates from the Astro team.
We also post release announcements to our Discord community in the #announcements channel.
Not every Astro release deserves its own blog post, but you can find a detailed changelog for every release in the
CHANGELOG.md file in the Astro repository.
If something is missing in the documentation or if you found some part confusing, please file an issue for the documentation with your suggestions for improvement, or tweet at the @astrodotbuild Twitter account. We love hearing from you!
This getting started guide was originally based off of React’s getting started guide.