Upgrade Astro from version 5 to 6

[dev-dist]

This pull request upgrades the project to Node.js 22 and updates major dependencies, including Astro and related integrations, to their latest versions. It also introduces improved handling for mixed React and Preact components by adding a custom integration that ensures the correct renderer is used, even when components are re-exported through shared barrel files. Additionally, configuration files and scripts are updated to reflect these changes and improve compatibility.

Node.js and Dependency Upgrades

• Updated the Node.js version requirement to 22.12.0 across .nvmrc, .tool-versions, package.json, and CI workflow files for consistency and to leverage the latest features and security updates. [1] [2] [3] [4] [5]
• Upgraded major dependencies: astro to 6.x, @astrojs/react, @astrojs/preact, @astrojs/mdx, @astrojs/prism, and @astrojs/vercel to their respective 5.x or 6.x versions, and vite to 7.x. [1] [2] [3] [4]

React/Preact Renderer Handling

• Added a new integration (src/integrations/jsx-renderer-tag) that automatically tags each component export with the correct renderer based on its @jsxImportSource pragma, ensuring correct SSR behavior even with barrel file imports. [1] [2] [3]
• Updated astro.config.ts to explicitly list all Preact files, ensuring that Preact and React integrations only process their intended files and preventing accidental miscompilation. [1] [2]

Configuration and Code Quality

• Added root: true to .eslintrc.cjs to ensure ESLint uses the correct configuration root.
• Added es-module-lexer as a new dependency to support the custom renderer tagging integration.
• Cleaned up legacy configuration in astro.config.ts and removed an unused import in src/features/utils/index.ts. [1] [2]

Other Compatibility Fixes

• Updated Zod usage in src/content.config.ts to use z.enum instead of z.nativeEnum for improved compatibility with the latest Astro versions. [1] [2]
• Fixed an async call to runHighlighterWithAstro in src/components/CodeSample/CodeSample.astro to use await, ensuring correct syntax highlighting.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
documentation	Ready	Preview	Aug 17, 2026 9:04pm