What is the minimum Node.js version required for Astro v6?

Astro v6 requires Node.js version 22.12.0 or higher.

How do I replace the deprecated ViewTransitions component?

In Astro v6, ViewTransitions has been renamed to ClientRouter. You should import { ClientRouter } from 'astro:transitions' and update your components accordingly.

Where should I move my content configuration file?

The configuration file should be moved from the legacy location at src/content/config.ts to the project root or src folder as src/content.config.ts.

What is the replacement for Astro.glob() in version 6?

Astro.glob() is deprecated in favor of Vite's standard import.meta.glob(). For similar behavior, use Object.values(import.meta.glob('./path/*.md', { eager: true })).

How should Zod be imported in Astro v6?

Instead of importing from 'astro:content' or 'astro:schema', you should now import { z } from 'astro/zod' to ensure compatibility with Zod 4.

Astro v6 Migration Guide

Name: Astro v6 Migration Guide
Author: ascorbic

byascorbic

•

Content Management

Streamlines the upgrade process for Astro projects moving from version 5 to 6 by automating migration steps and identifying deprecated APIs.

About

This skill provides a comprehensive roadmap for upgrading Astro applications to version 6, ensuring a smooth transition by handling Node.js version requirements, Content Layer API migrations, and critical breaking changes. It offers step-by-step guidance for replacing legacy ViewTransitions with ClientRouter, updating Zod schemas to version 4 syntax, and resolving deprecated API errors. By utilizing this skill, developers can quickly identify and fix migration issues related to content collections, asset utilities, and experimental flags, helping maintain modern, high-performance Astro sites with minimal manual troubleshooting.

Key Features

1 GitHub stars
Step-by-step instructions for removing deprecated experimental flags and APIs
Node.js 22.12.0+ compatibility checks and upgrade path guidance
Automated detection and migration of Legacy Content Collections to the Content Layer API
Quick-fix replacements for ViewTransitions, Astro.glob, and Zod schema imports
Comprehensive error reference library for common v6 migration pitfalls

Use Cases

Migrating legacy Markdown content folders to the modernized and faster Content Layer architecture
Resolving build errors caused by deprecated Astro.site, Astro.generator, or emitESMImage APIs
Upgrading a production Astro blog from v5 to v6 while preserving complex content schemas

About

Key Features

1 GitHub stars
Step-by-step instructions for removing deprecated experimental flags and APIs
Node.js 22.12.0+ compatibility checks and upgrade path guidance
Automated detection and migration of Legacy Content Collections to the Content Layer API
Quick-fix replacements for ViewTransitions, Astro.glob, and Zod schema imports
Comprehensive error reference library for common v6 migration pitfalls

Use Cases

Migrating legacy Markdown content folders to the modernized and faster Content Layer architecture
Resolving build errors caused by deprecated Astro.site, Astro.generator, or emitESMImage APIs
Upgrading a production Astro blog from v5 to v6 while preserving complex content schemas