Covers initial project setup and migration from Astro 5/6, including breaking changes and Node 22.12+ requirements. Does not cover Content Layer API details (astro-content), Server Actions (astro-actions), Islands hydration directives (astro-islands), UI framework integrations (astro-integrations), or deployment adapters (astro-deployment) — those live in their own skills.
Astro 7 Expert
Production-ready web framework for content-driven sites with unified dev runtime and Islands Architecture.
Agent Workflow (MANDATORY)
Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:
- fuse-ai-pilot:explore-codebase - Analyze existing routes, layouts, and config
- fuse-ai-pilot:research-expert - Verify latest Astro 7 docs via Context7/Exa
- mcp__context7__query-docs - Check breaking changes v6→v7
After implementation, run fuse-ai-pilot:sniper for validation.
Overview
When to Use
- Building new content-driven websites or blogs
- Migrating from Astro 6 to version 7
- Configuring static, server, or hybrid output modes
- Setting up middleware for auth or redirects
- Leveraging the new Rust compiler for large sites
- Implementing Content Security Policy (CSP) headers
Why Astro 7
| Feature |
Benefit |
| Unified Dev Runtime |
Dev matches production — fewer "works in dev, breaks in prod" bugs |
| Vite Environment API (Vite 8) |
Exact production runtime during development |
| Single Rust Compiler |
Go compiler removed — one Rust compiler for .astro files, with strict HTML parsing (unclosed tags now error instead of being silently auto-corrected) |
| Live Content Collections |
Real-time data from external sources |
| Built-in Fonts API (stable) |
Zero-config font loading with performance optimization |
| CSP Support (stable) |
Built-in Content Security Policy nonce management |
| Cloudflare Workers |
First-class support with workerd runtime in dev |
Core Concepts
Output Modes
| Mode |
Description |
Use Case |
static (default) |
All pages prerendered at build |
Blogs, docs, marketing |
server |
All pages rendered on demand |
Apps, dashboards, auth |
hybrid |
Mix static + on-demand |
Most production sites |
Routing
- File-based routing —
src/pages/ maps directly to URLs
- Dynamic routes —
[slug].astro, [...all].astro
- Per-route prerender —
export const prerender = false/true
- Endpoints —
.ts/.js files in src/pages/ for API routes
Reference Guide
| Need |
Reference |
| Initial setup |
installation.md |
| Routing patterns |
routing.md |
| Output configuration |
output-modes.md |
| Middleware setup |
middleware.md |
| astro.config.ts |
config.md |
| New Astro 7 features |
new-features.md |
| Full project setup |
templates/basic-setup.md |
| Config examples |
templates/config-example.md |
Best Practices
- Use
output: 'static' by default — Add server only when needed
- Per-route
prerender — Fine-grained control in hybrid mode
- Middleware for cross-cutting concerns — Auth, redirects, headers
- No compiler flag needed — the Rust compiler is the only compiler now (Go removed); watch for strict HTML parsing errors on unclosed tags
- CSP nonces — Use built-in stable support instead of custom headers
- Node 22.12+ required — odd-numbered Node versions are unsupported; stay on stable TypeScript tooling, the native
tsgo compiler can make astro check/typecheck fail opaquely (see installation.md)
1---2name: astro-73description: Use when building Astro 7 sites, choosing an output mode (static/server/hybrid), configuring middleware, or upgrading from Astro 5/6.4versions:5 astro: "7"6 node: "22.12+"7 vite: 88user-invocable: true9references: references/installation.md, references/routing.md, references/output-modes.md, references/middleware.md, references/config.md, references/new-features.md, references/templates/basic-setup.md, references/templates/config-example.md10related-skills: astro-content, astro-actions, astro-islands, astro-integrations, astro-deployment11metadata:12 source: https://skillmd.com/skills/fusengine/astro-713---1415<objective>16Configures and explains Astro 7 (stable, 7.0.9) core framework mechanics: file-based routing, the three output modes (static/server/hybrid) and per-route `prerender`, middleware for auth/redirects/headers, the Vite Environment API, the single Rust compiler (Go compiler removed, strict HTML parsing), stable Content Security Policy, Live Content Collections, and the built-in Fonts API.1718Covers initial project setup and migration from Astro 5/6, including breaking changes and Node 22.12+ requirements. Does not cover Content Layer API details (astro-content), Server Actions (astro-actions), Islands hydration directives (astro-islands), UI framework integrations (astro-integrations), or deployment adapters (astro-deployment) — those live in their own skills.19</objective>2021# Astro 7 Expert2223Production-ready web framework for content-driven sites with unified dev runtime and Islands Architecture.2425## Agent Workflow (MANDATORY)2627Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:28291. **fuse-ai-pilot:explore-codebase** - Analyze existing routes, layouts, and config302. **fuse-ai-pilot:research-expert** - Verify latest Astro 7 docs via Context7/Exa313. **mcp__context7__query-docs** - Check breaking changes v6→v73233After implementation, run **fuse-ai-pilot:sniper** for validation.3435---3637## Overview3839### When to Use4041- Building new content-driven websites or blogs42- Migrating from Astro 6 to version 743- Configuring static, server, or hybrid output modes44- Setting up middleware for auth or redirects45- Leveraging the new Rust compiler for large sites46- Implementing Content Security Policy (CSP) headers4748### Why Astro 74950| Feature | Benefit |51|---------|---------|52| Unified Dev Runtime | Dev matches production — fewer "works in dev, breaks in prod" bugs |53| Vite Environment API (Vite 8) | Exact production runtime during development |54| Single Rust Compiler | Go compiler removed — one Rust compiler for `.astro` files, with strict HTML parsing (unclosed tags now error instead of being silently auto-corrected) |55| Live Content Collections | Real-time data from external sources |56| Built-in Fonts API (stable) | Zero-config font loading with performance optimization |57| CSP Support (stable) | Built-in Content Security Policy nonce management |58| Cloudflare Workers | First-class support with workerd runtime in dev |5960---6162## Core Concepts6364### Output Modes6566| Mode | Description | Use Case |67|------|-------------|----------|68| `static` (default) | All pages prerendered at build | Blogs, docs, marketing |69| `server` | All pages rendered on demand | Apps, dashboards, auth |70| `hybrid` | Mix static + on-demand | Most production sites |7172### Routing7374- **File-based routing** — `src/pages/` maps directly to URLs75- **Dynamic routes** — `[slug].astro`, `[...all].astro`76- **Per-route prerender** — `export const prerender = false/true`77- **Endpoints** — `.ts`/`.js` files in `src/pages/` for API routes7879---8081## Reference Guide8283| Need | Reference |84|------|-----------|85| Initial setup | [installation.md](references/installation.md) |86| Routing patterns | [routing.md](references/routing.md) |87| Output configuration | [output-modes.md](references/output-modes.md) |88| Middleware setup | [middleware.md](references/middleware.md) |89| astro.config.ts | [config.md](references/config.md) |90| New Astro 7 features | [new-features.md](references/new-features.md) |91| Full project setup | [templates/basic-setup.md](references/templates/basic-setup.md) |92| Config examples | [templates/config-example.md](references/templates/config-example.md) |9394---9596## Best Practices97981. **Use `output: 'static'` by default** — Add server only when needed992. **Per-route `prerender`** — Fine-grained control in hybrid mode1003. **Middleware for cross-cutting concerns** — Auth, redirects, headers1014. **No compiler flag needed** — the Rust compiler is the only compiler now (Go removed); watch for strict HTML parsing errors on unclosed tags1025. **CSP nonces** — Use built-in stable support instead of custom headers1036. **Node 22.12+ required** — odd-numbered Node versions are unsupported; stay on stable TypeScript tooling, the native `tsgo` compiler can make `astro check`/typecheck fail opaquely (see installation.md)