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

•

개발자 도구

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

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.

주요 기능

011 GitHub stars

02Step-by-step instructions for removing deprecated experimental flags and APIs

03Node.js 22.12.0+ compatibility checks and upgrade path guidance

04Automated detection and migration of Legacy Content Collections to the Content Layer API

05Quick-fix replacements for ViewTransitions, Astro.glob, and Zod schema imports

06Comprehensive error reference library for common v6 migration pitfalls

사용 사례

01Migrating legacy Markdown content folders to the modernized and faster Content Layer architecture

02Resolving build errors caused by deprecated Astro.site, Astro.generator, or emitESMImage APIs

03Upgrading a production Astro blog from v5 to v6 while preserving complex content schemas

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ascorbic/skills astro-v6-upgrade

For use in Claude.ai and ChatGPT

Download Skill