chore(docs): upgrade Astro 5→6, Starlight 0.36→0.38, starlight-blog 0.25→0.26 by leaanthony · Pull Request #5285 · wailsapp/wails

leaanthony · 2026-04-29T20:45:05Z

Summary

Coordinated upgrade of the docs build stack to latest releases.
@astrojs/starlight 0.36.2 → 0.38.4 (latest)
starlight-blog 0.25.1 → 0.26.1 (latest)
astro ^5.0.0 → ^6.0.0 (forced by Starlight 0.38)
Supporting plugins bumped to versions that support the new peer-deps:
@astrojs/check, @astrojs/react, astro-d2, starlight-image-zoom, starlight-links-validator, starlight-showcases.

Why

Triggered by reports that v3 site search returns URLs with a .md suffix that 404. A coordinated rebuild on the latest stack is the cleanest fix path — newer plugin versions also include unrelated bug fixes since the November 2025 redesign bump.

Test plan

Cloudflare Pages preview build for this PR succeeds.
Preview URL: blog post links in the left sidebar resolve without .md.
Preview URL: pagefind search results for "alpha10" / "v3 roadmap" resolve to working pages.
Preview URL: spot-check a few d2 diagrams render (astro-d2 major bump).
No astro check errors in CI build log.

🤖 Generated with Claude Code

Summary by CodeRabbit

Chores
- Updated multiple documentation dependencies to newer compatible versions, including major upgrades of core build libraries and supporting packages.
New Features / Improvements
- Switched the documentation content and translation handling to a new loading approach for more reliable content delivery and i18n support.

….25→0.26 Coordinated bump of the docs build stack to the latest releases. Starlight 0.38 requires Astro 6, and starlight-blog 0.26 requires Starlight ≥ 0.38, so the three move together. Plugins (links-validator, image-zoom, showcases, astro-d2) and the React integration are bumped to versions that support the new peer-deps. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

coderabbitai · 2026-04-29T20:45:28Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: beab7b8a-a2e3-4526-b3f2-35f51bb1c0e8

📥 Commits

Reviewing files that changed from the base of the PR and between 235e0d8 and 88be23b.

⛔ Files ignored due to path filters (1)

docs/package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (1)

docs/src/content.config.ts

Walkthrough

Updated documentation dependencies (multiple Astro and Starlight packages, including astro ^5→^6 and astro-d2 ^0.5→^0.10) and switched two content collections to use loaders (i18nLoader() and docsLoader()) while keeping existing schemas. No other logic or scripts changed.

Changes

Cohort / File(s)	Summary
Documentation dependencies `docs/package.json`	Bumped multiple dependency versions: `astro` ^5 → ^6, `astro-d2` ^0.5 → ^0.10, and updated `@astrojs/`, `starlight-` packages to newer releases. No script or source code edits.
Content collection config `docs/src/content.config.ts`	Replaced `type: "data"` with `loader: i18nLoader()` for the `i18n` collection; added `loader: docsLoader()` to the `docs` collection. Schemas (`i18nSchema()`, `docsSchema()`/`blogSchema`) remain unchanged.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 I hopped through package trees with glee,

Pushed versions up—now look and see!
Loaders added, schemas stay,
Docs refreshed for a brighter day. ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The PR description provides a clear summary of changes, motivation (fixing .md suffix issue in search results), and a detailed test plan. However, it does not follow the repository's required PR template structure and does not include required checklist items or platform testing confirmation.	Review the provided template structure: include the standard checklist sections, specify type of change, provide test configuration details, and ensure all required sections are completed per repository guidelines.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately and specifically summarizes the main changes: coordinated upgrades of Astro (5→6), Starlight (0.36→0.38), and starlight-blog (0.25→0.26), which aligns with the primary changeset and PR objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch chore/upgrade-starlight

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Review rate limit: 5/8 reviews remaining, refill in 18 minutes and 6 seconds.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

Copilot

Pull request overview

Upgrades the v3 documentation site’s Astro/Starlight build toolchain to newer upstream releases, aiming to resolve docs-site URL/search issues and pick up plugin fixes.

Changes:

Bump astro from ^5.0.0 → ^6.0.0.
Upgrade @astrojs/starlight and starlight-blog to newer versions.
Update related Astro/Starlight integrations (@astrojs/check, @astrojs/react, astro-d2, and Starlight plugins).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

+    "@astrojs/check": "^0.9.9",
+    "@astrojs/react": "^5.0.4",
+    "@astrojs/starlight": "0.38.4",
    "@types/react": "^19.0.1",
    "@types/react-dom": "^19.0.2",
-    "astro": "^5.0.0",
-    "astro-d2": "^0.5.0",
+    "astro": "^6.0.0",
+    "astro-d2": "^0.10.0",
    "framer-motion": "^11.14.4",
    "motion": "^11.14.4",
    "react": "^19.0.0",
    "react-dom": "^19.0.0",
    "sharp": "^0.33.5",
-    "starlight-blog": "0.25.1",
-    "starlight-image-zoom": "^0.9.0",
-    "starlight-links-validator": "^0.13.4",
-    "starlight-showcases": "^0.2.0",
+    "starlight-blog": "0.26.1",
+    "starlight-image-zoom": "^0.14.1",
+    "starlight-links-validator": "^0.24.0",
+    "starlight-showcases": "^0.3.2",
    "typescript": "^5.7.2"


…onfig - Regenerate package-lock.json against the bumped package.json so npm ci can resolve the new peer-deps in CF Pages. - Move src/content/config.ts → src/content.config.ts and add explicit loaders (docsLoader / i18nLoader) — Astro 6 removed legacy content collections and now requires this layout. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

…upgrade Astro 5→6, Starlight 0.36→0.38, starlight-blog 0.25→0.26

Copilot AI review requested due to automatic review settings April 29, 2026 20:45

Copilot AI reviewed Apr 29, 2026

View reviewed changes

leaanthony and others added 4 commits April 30, 2026 06:48

chore: kick CF preview build

0e22bed

chore(docs): pin Node 22.12 for Astro 6

2e4dc68

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

chore(docs): drop .nvmrc, NODE_VERSION set via CF Pages env

88be23b

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

leaanthony merged commit 232e3ad into master Apr 29, 2026
16 checks passed

leaanthony deleted the chore/upgrade-starlight branch April 29, 2026 21:21

pull Bot pushed a commit to nagyist/wails that referenced this pull request Apr 29, 2026

chore(changelog): auto-add entry for PR wailsapp#5285 — chore(docs): …

fce349e

…upgrade Astro 5→6, Starlight 0.36→0.38, starlight-blog 0.25→0.26

coderabbitai Bot mentioned this pull request May 13, 2026

chore(deps): clear all open Dependabot security alerts #5429

Closed

7 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

chore(docs): upgrade Astro 5→6, Starlight 0.36→0.38, starlight-blog 0.25→0.26#5285

chore(docs): upgrade Astro 5→6, Starlight 0.36→0.38, starlight-blog 0.25→0.26#5285
leaanthony merged 5 commits into
masterfrom
chore/upgrade-starlight

leaanthony commented Apr 29, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

coderabbitai Bot commented Apr 29, 2026 •

edited

Loading

❌ Failed checks (1 inconclusive)

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

leaanthony commented Apr 29, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Why

Test plan

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Apr 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Estimated code review effort

Poem

❌ Failed checks (1 inconclusive)

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

leaanthony commented Apr 29, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Apr 29, 2026 •

edited

Loading