Astro Web Framework

6.1.7 · active · verified Sat Apr 18

Astro is an all-in-one web framework designed for building fast websites with a focus on web best practices and developer experience. It enables developers to pull content from anywhere and deploy everywhere, utilizing their favorite UI components and libraries. The current stable version is 6.1.7, with frequent patch releases addressing bug fixes and improvements across the core framework and its various adapters and integrations.

Common errors

```
ActionsWithoutServerOutputError
```
cause Using `output: 'static'` with an adapter in Astro versions prior to 6.1.6.

fix Update your `astro` package to version `6.1.6` or higher (`npm install astro@latest`).
```
Unknown file extension ".svelte"
```
cause This error can occur when using the Cloudflare adapter with `prerenderEnvironment: 'node'` and having Svelte files in `node_modules` on older `@astrojs/svelte` or `@astrojs/cloudflare` versions.

fix Update `@astrojs/svelte` to `8.0.5` or later and `@astrojs/cloudflare` to `13.1.9` or later (`npm update @astrojs/svelte @astrojs/cloudflare`).
```
ERR_MULTIPLE_CONSUMERS
```
cause This error occurs when using Cloudflare Queues alongside prerendered pages with older versions of the `@astrojs/cloudflare` adapter.

fix Update `@astrojs/cloudflare` to version `13.1.8` or later (`npm update @astrojs/cloudflare`).

Warnings

breaking Astro 6.x requires Node.js version 22.12.0 or higher to run. Projects on older Node.js versions will fail to start or build.
Fix: Upgrade your Node.js environment to version 22.12.0 or newer.
gotcha When using `output: 'static'` with an adapter, builds could fail with an `ActionsWithoutServerOutputError`.
Fix: Upgrade the `astro` package to version 6.1.6 or later.
gotcha Svelte files located within `node_modules` might fail with an `Unknown file extension ".svelte"` error when using the Cloudflare adapter with `prerenderEnvironment: 'node'`.
Fix: Upgrade `@astrojs/svelte` to version 8.0.5 or later, and `@astrojs/cloudflare` to 13.1.9 or later.
gotcha When using Cloudflare Queues with prerendered pages, an `ERR_MULTIPLE_CONSUMERS` error could occur.
Fix: Upgrade the `@astrojs/cloudflare` package to version 13.1.8 or later.

Install

npm install astro npm
yarn add astro yarn
pnpm add astro pnpm

Quickstart

Initializes a new Astro project using the latest version, guiding you through setup options like framework integrations and project structure.

npm create astro@latest

# Follow the prompts to set up your project

view raw JSON →