Summary
Starlight 0.41.0 is out and we'd like to adopt it. It is not a standalone bump: 0.41 requires Astro v7 and drops Astro v6. We currently run Astro 6.4.4 / Starlight 0.39.3, so this is an Astro 6→7 major upgrade that moves the whole Starlight plugin stack in lockstep.
Every plugin we use already has an Astro-7-compatible release except starlight-llms-txt, so the upgrade is currently blocked.
Blocker
starlight-llms-txt@0.10.0 still pins astro: ^6.0.0 and has no Astro 7 release. This plugin generates /llms.txt, which is core to the TextRefs "machine-readable registry" mission — so we will not drop it or force a package-manager override.
The fix is already in flight upstream: delucis/starlight-llms-txt#127 bumps the astro peer to ^7.0.0 and @astrojs/starlight to >=0.41.0 (dropping Astro 6 / Starlight <0.41). As of 2026-06-29 it is open, not merged, not released (changeset queued as a minor bump, awaiting maintainer review).
➡️ When PR #127 merges and ships a release, this upgrade is unblocked. This issue tracks that.
Dependency matrix
| Package |
Installed |
Target |
Astro 7 status |
| astro |
6.4.4 |
7.0.3 |
— |
| @astrojs/starlight |
0.39.3 |
0.41.1 |
✅ peer astro ^7.0.2 |
| starlight-blog |
0.26.1 |
0.27.0 |
✅ peer @astrojs/starlight >=0.41.0 |
| starlight-openapi |
0.25.3 |
0.26.0 |
✅ but adds new peer @astrojs/markdown-satteri >=0.3.2 |
| starlight-links-validator |
0.24.0 |
0.25.2 |
✅ peer astro >=7.0.2 |
| astro-mermaid |
2.0.2 |
2.1.0 |
✅ peer astro >=4 |
| starlight-llms-txt |
0.10.0 |
pending |
❌ blocked — see PR #127 |
Migration checklist (execute once unblocked)
Notes
- Starlight 0.40.0 raised the floor to Astro 6.4.5 and introduced the
@astrojs/markdown-satteri processor; 0.41 builds on Astro 7.
- Starlight 0.41 drops browser support for Chromium <111 and Safari <16.4.
- All six integrations are configured together in
astro.config.mjs, so they must be upgraded as a unit.
- Node is not a constraint (repo targets Node 24).
References
Summary
Starlight 0.41.0 is out and we'd like to adopt it. It is not a standalone bump: 0.41 requires Astro v7 and drops Astro v6. We currently run Astro 6.4.4 / Starlight 0.39.3, so this is an Astro 6→7 major upgrade that moves the whole Starlight plugin stack in lockstep.
Every plugin we use already has an Astro-7-compatible release except
starlight-llms-txt, so the upgrade is currently blocked.Blocker
starlight-llms-txt@0.10.0still pinsastro: ^6.0.0and has no Astro 7 release. This plugin generates/llms.txt, which is core to the TextRefs "machine-readable registry" mission — so we will not drop it or force a package-manager override.The fix is already in flight upstream: delucis/starlight-llms-txt#127 bumps the
astropeer to^7.0.0and@astrojs/starlightto>=0.41.0(dropping Astro 6 / Starlight <0.41). As of 2026-06-29 it is open, not merged, not released (changeset queued as a minor bump, awaiting maintainer review).➡️ When PR #127 merges and ships a release, this upgrade is unblocked. This issue tracks that.
Dependency matrix
astro ^7.0.2@astrojs/starlight >=0.41.0@astrojs/markdown-satteri >=0.3.2astro >=7.0.2astro >=4Migration checklist (execute once unblocked)
starlight-llms-txtAstro 7 release (PR #127).npx @astrojs/upgradeand review the Astro v7 upgrade guide.@astrojs/markdown-satteri(new peer ofstarlight-openapi@0.26).npm run verify(format:check +astro check+ build) andnpm run check:links./llms.txt, the/api/OpenAPI pages, mermaid diagrams, and the blog.Notes
@astrojs/markdown-satteriprocessor; 0.41 builds on Astro 7.astro.config.mjs, so they must be upgraded as a unit.References