Getting Started

Static Site Generator 🚀 Bring your own Framework 🚀 Ship Less JavaScript

We’ve made it as easy as possible to get started with Astro either in your browser, or on your machine!

Visit astro.new for the easiest way to “try before you buy.” Choose from a variety of starter templates and start building a full, working version of Astro right in your browser!

Or, instantly launch our basic starter project with just one click of a button:

Ready to install?

Get a new project up and running locally in no time with our easy create-astro CLI wizard!

# make a new project directory and jump into it
mkdir my-astro-project && cd $_

# create a new project with npm
npm create astro@latest

# or yarn
yarn create astro

# or pnpm
pnpm create astro@latest

⚙️ Our Installation Guide has full, step-by-step instructions for installing Astro with your favourite package manager.

⚙️ See instructions for manual setup instead.

Jump right in and add some content and features to your site!

🏗️ Add new Astro (.astro) pages and/or Markdown (.md) pages to your site.

🏗️ Create your first Layout.

🏗️ Add additional CSS and styling to your site.

… and even more Guides under Learn

See examples of some of the key concepts and patterns of an Astro site!

📚 Read more about Astro’s project structure.

📚 Learn more about Astro’s built-in components.

📚 Explore Astro’s API.

… and even more reference material under API

Explore different integrations that our users have combined with Astro!

🧰 Use a CMS with your Astro project.

🧰 Set up eCommerce.

🧰 Connect a database to your site.

… see our third-party integrations

Join us in the Astro Discord to share with and get help from an active, friendly community!

💬 Say hi in our #introduce-yourself channel!

💬 Ask our Support Squad a question in our #support channel!

💬 Share what you’ve been working on in our #showcase channel!

Astro Blog

Astro changelog

Astro Migration Guide (for upgrading to v0.21+)

These docs are brought to you by all these helpful people. Join us on GitHub!