Skip to content

fix(website): upgrade to Astro v6 and Starlight 0.38.x#701

Closed
bryan-thompsoncodes wants to merge 1 commit intomainfrom
fix/starlight-038-compat
Closed

fix(website): upgrade to Astro v6 and Starlight 0.38.x#701
bryan-thompsoncodes wants to merge 1 commit intomainfrom
fix/starlight-038-compat

Conversation

@bryan-thompsoncodes
Copy link
Copy Markdown
Collaborator

Summary

Upgrades the website to Astro v6 and Starlight 0.38.x to resolve the build error caused by Dependabot PR #692.

Problem

Dependabot PR #692 bumped @astrojs/starlight from 0.37.7 to 0.38.3, but Starlight 0.38.x requires Astro v6 (dropping v5 support). This caused:

[vite] The requested module 'astro/zod' does not provide an export named 'locales'

The locales export is an Astro v6 API that Starlight 0.38.x depends on internally. No code changes in our repo reference it — it's inside Starlight's own integration code.

Changes

  • astro: ^5.18.1^6.0.0 (required by Starlight 0.38.x)
  • @astrojs/starlight: ^0.37.7^0.38.3
  • @astrojs/react: ^4.4.2^5.0.0 (Astro v6 compatible line)
  • starlight-links-validator: ^0.14.3^0.23.0 (Zod 4 compatible — Astro v6 ships Zod 4)
  • Updated pnpm-lock.yaml

No code changes needed

The website's content.config.ts already uses the Content Layer API (docsLoader/docsSchema), and astro.config.mjs required no changes. The upgrade was purely dependency versions.

Verification

  • pnpm run build — 145 pages built successfully
  • pnpm run checks — lint, format, types, astro check, spelling all pass
  • pnpm run test — 13 tests pass (vitest)

Notes

Closes #692

Starlight 0.38.x requires Astro v6, which includes Zod 4 and Vite 7.

- Upgrade astro from ^5.18.1 to ^6.0.0
- Upgrade @astrojs/starlight from ^0.37.7 to ^0.38.3
- Upgrade @astrojs/react from ^4.4.2 to ^5.0.0
- Upgrade starlight-links-validator from ^0.14.3 to ^0.23.0 (Zod 4 compat)
- Update pnpm-lock.yaml

Resolves the build error:
  [vite] The requested module 'astro/zod' does not provide an export named 'locales'

This was caused by Starlight 0.38.x using Astro v6 APIs not present in v5.

Closes #692
@github-actions github-actions bot added website Issues related to the website dependencies Pull requests that update a dependency file typescript Issue or PR related to TypeScript tooling labels Apr 9, 2026
@bryan-thompsoncodes bryan-thompsoncodes deleted the fix/starlight-038-compat branch April 10, 2026 01:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file typescript Issue or PR related to TypeScript tooling website Issues related to the website

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant