Skip to main content

Astro documentation

Welcome to Astro! The web framework for building content-driven websites like blogs, marketing, documentation sites, and e-commerce. Astro is best-known for pioneering a new frontend architecture to reduce JavaScript overhead and complexity compared to other frameworks.

Install Astro

Get started with Astro using our CLI wizard and create your first project in minutes.

Why choose Astro?

Learn about Astro’s features and design principles that make it perfect for content-driven sites.

Project structure

Understand how an Astro project is organized and where to place your files.

Browse starter themes

Explore themes for blogs, portfolios, docs, landing pages, SaaS, marketing, and more.

Start a new project

The fastest way to get started is using the create astro CLI command:
npm create astro@latest
Our installation guide has step-by-step instructions for installing Astro using the CLI wizard, creating a new project from an existing GitHub repository, and installing Astro manually.
Prefer to try Astro in your browser? Visit astro.new to browse starter templates and spin up a new Astro project without ever leaving your browser.

What you’ll learn

Core concepts

  • Astro’s main features and benefits
  • Islands architecture
  • Astro components
  • The Astro template syntax

Extend your project

  • Add integrations like React and Tailwind
  • Create type-safe content collections
  • Enhance navigation with view transitions
  • Connect a headless CMS

Key features

Astro is an all-in-one web framework that includes everything you need to create a website, built-in. There are also hundreds of different integrations and API hooks available to customize a project to your exact use case and needs.

Islands architecture

A component-based web architecture optimized for content-driven websites.

UI-agnostic

Supports React, Preact, Svelte, Vue, Solid, HTMX, web components, and more.

Server-first

Moves expensive rendering off of your visitors’ devices for better performance.

Zero JS by default

Less client-side JavaScript to slow your site down — ships only what you need.

Content collections

Organize, validate, and provide TypeScript type-safety for your Markdown content.

Highly customizable

Choose from hundreds of integrations like MDX, Tailwind, Partytown, and more.