Skip to content

Upgrade Astro 5 → 6 and Starlight 0.34 → 0.38 - #37

Open
ejntaylor wants to merge 2 commits into
mainfrom
ejntaylor/astro-6-upgrade
Open

Upgrade Astro 5 → 6 and Starlight 0.34 → 0.38#37
ejntaylor wants to merge 2 commits into
mainfrom
ejntaylor/astro-6-upgrade

Conversation

@ejntaylor

Copy link
Copy Markdown
Contributor

Summary

  • Bumps Astro to v6, Starlight to v0.38, and Astro-6-compatible releases of starlight-openapi, starlight-llms-txt, and astro-og-canvas.
  • Adds @astrojs/compiler-rs as an explicit dependency so Rollup can resolve Astro's dynamic import during the static build (Astro 6 ships a dynamic import("@astrojs/compiler-rs") but does not declare it in its own dependencies).
  • Two small code changes for v6:
    • src/content.config.ts: import z from astro/zod (the astro:content re-export is deprecated in v6).
    • src/pages/open-graph/[...route].js: rename slugid (Astro 6 removed the legacy content-collection backwards-compat shim, so docsLoader entries now expose id only) and await OGImageRoute(...) (its return type is now a Promise).

Versions

Package From To
astro ^5.9.2 ^6.0.0 (resolves to 6.1.9)
@astrojs/starlight ^0.34.3 ^0.38.4
@astrojs/sitemap ^3.4.1 ^3.7.2
starlight-openapi ^0.22.1 ^0.25.0
starlight-llms-txt ^0.5.1 ^0.8.1
astro-og-canvas ^0.5.3 ^0.11.1
@astrojs/compiler-rs ^0.1.9 (new)

Test plan

  • npm install succeeds with no peer-dependency errors
  • npm run build completes (190 pages, including all three OpenAPI references and OG images)
  • npm run dev boots; home page returns 200
  • Spot-check sidebar navigation, search (Pagefind), and OpenAPI reference pages in a deploy preview
  • Verify generated llms.txt / llms-full.txt look right
  • Confirm OG images render correctly (Twitter / Slack share preview)

Notes

  • Node ≥ 22.12.0 is now required (Astro 6 dropped Node 18/20). Local dev uses Node 22.19.0 — confirm CI / Netlify build image.
  • No usage of Astro.glob, <ViewTransitions />, emitESMImage, loadManifest, loadApp, NodeApp, or ASSETS_PREFIX in the codebase, so the major v6 removals don't apply here.

🤖 Generated with Claude Code

Bumps Astro to v6, Starlight to v0.38, and all related plugins
(starlight-openapi, starlight-llms-txt, astro-og-canvas) to their
first Astro-6-compatible releases. Adds @astrojs/compiler-rs as an
explicit dependency so Rollup can resolve Astro's dynamic import.

Code changes for v6 compatibility:
- src/content.config.ts: import `z` from `astro/zod` (the
  `astro:content` re-export is deprecated in v6).
- src/pages/open-graph/[...route].js: rename `slug` → `id` (the
  legacy content-collection backwards-compat shim was removed) and
  `await OGImageRoute(...)` (its return type is now a Promise).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@netlify

netlify Bot commented Apr 24, 2026

Copy link
Copy Markdown

Deploy Preview for deluxe-meerkat-8daf24 failed.

Name Link
🔨 Latest commit 3ecbdef
🔍 Latest deploy log https://app.netlify.com/projects/deluxe-meerkat-8daf24/deploys/69eb2aa16d9fa20008313e5d
@coderbuds

coderbuds Bot commented Apr 24, 2026

Copy link
Copy Markdown

Dependency update with supporting changes.

🎯 Quality: 75% Good · 📦 Size: Tiny

📈 This month: Your 260th PR — above team average · Averaging Good

See how your team is trending →

Astro 6 requires Node >= 22.12. Netlify does not pin a Node version for
this project (no .nvmrc / engines / NODE_VERSION), so the build image can
fall back to an older default and fail. Build-time only — the site is a
static export served from the CDN with no Node runtime.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@netlify

netlify Bot commented Jul 8, 2026

Copy link
Copy Markdown

Deploy Preview for deluxe-meerkat-8daf24 ready!

Name Link
🔨 Latest commit 1d88e25
🔍 Latest deploy log https://app.netlify.com/projects/deluxe-meerkat-8daf24/deploys/6a4e19ee4021020008616add
😎 Deploy Preview https://deploy-preview-37--deluxe-meerkat-8daf24.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderbuds

coderbuds Bot commented Aug 5, 2026

Copy link
Copy Markdown

This PR has been waiting for review for over 48 hours. A reviewer nudge has been sent.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant