Skip to content

chore(deps): upgrade to Astro 7 and Starlight 0.41, migrate to starlight-sidebar-topics#803

Merged
andrii-bodnar merged 3 commits into
mainfrom
chore/upgrade-astro-7
Jul 7, 2026
Merged

chore(deps): upgrade to Astro 7 and Starlight 0.41, migrate to starlight-sidebar-topics#803
andrii-bodnar merged 3 commits into
mainfrom
chore/upgrade-astro-7

Conversation

@andrii-bodnar

Copy link
Copy Markdown
Member

No description provided.

@vercel

vercel Bot commented Jul 7, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Jul 7, 2026 1:51pm

Request Review

vite-plugin-static-copy v4 preserves each matched file's full relative
source directory under `dest` (v3 appended only the basename), so the
existing `dest` values produced doubled paths (e.g. dist/src/src/scripts)
and the Redoc scripts, bundle, and API specs 404'd on the deployed build.
Set each `dest` to '' so copied files keep their root-relative paths.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Upgrades the docs site to Astro 7 + Starlight 0.41 and replaces the previous multi-sidebar/nav approach with starlight-sidebar-topics, including component overrides to keep the topic switcher in the header.

Changes:

  • Upgraded core dependencies (Astro/Starlight and related plugins) and adjusted config to match new APIs.
  • Migrated sidebar configuration to the starlight-sidebar-topics model and updated sidebar definitions accordingly.
  • Added Starlight component overrides (SiteTitle/Sidebar) to restore the prior header navigation layout and suppress the plugin’s default in-sidebar topic list.

Reviewed changes

Copilot reviewed 12 out of 13 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/utils/starlightRoute.ts Migrates route parsing/homepage detection from slug to id for newer Starlight route data.
src/pages/og/[...slug].ts Updates OG image route configuration for the upgraded astro-og-canvas API.
src/content/sidebars/enterprise.ts Updates Enterprise sidebar structure to the newer autogenerate schema.
src/content/sidebars/developer.ts Updates Developer sidebar structure to the newer autogenerate schema.
src/content/sidebars/crowdin.ts Updates Crowdin sidebar structure to the newer autogenerate schema.
src/content/docs/index.mdx Tweaks homepage grid styling to remove underlines from links inside cards.
src/content.config.ts Updates content config imports and switches z to astro/zod for the upgraded content APIs.
src/components/SiteTitle.astro Introduces a custom SiteTitle to render topic + external navigation links in the header.
src/components/Sidebar.astro Overrides Sidebar to render only the default Starlight sidebar (no in-sidebar topic list).
src/components/Head.astro Simplifies header/nav styling responsibilities and keeps OG meta + custom behaviors.
package.json Bumps Astro/Starlight and related dependency versions; adds starlight-sidebar-topics.
astro.config.mjs Replaces starlight-utils config with starlight-sidebar-topics, adds component overrides, and updates trailingSlash/static-copy configuration.
Comments suppressed due to low confidence (1)

src/utils/starlightRoute.ts:20

  • This variable is now derived from route.id, so the name slugSegments is misleading. Renaming it to reflect the new source makes the intent clearer and avoids confusion during future route-related changes.
  const slugSegments = route.id.split('/').filter(Boolean);
  const nonLocaleSegments =
    route.locale && slugSegments[0] === route.locale
      ? slugSegments.slice(1)
      : slugSegments;

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

Comment thread src/components/SiteTitle.astro
@andrii-bodnar andrii-bodnar merged commit 52b5236 into main Jul 7, 2026
5 checks passed
@andrii-bodnar andrii-bodnar deleted the chore/upgrade-astro-7 branch July 7, 2026 14:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants