unstale

npm / @astrojs/starlight

@astrojs/starlight

What changed in @astrojs/starlight 0.41 to 0.42, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.

7 breaking7 new APIs and options2 performance1 tooling14 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.0 on npm

@astrojs/starlight 0.4219 changes

Breaking changes 7

  • Starlight now requires Astro v7.2.10 or later; update Starlight and Astro together.

    0.42.0release notes

  • If used, this integration must be version 7.3.0 or later.

    0.42.0release notes

  • If used, this integration must be version 0.4.0 or later.

    0.42.0release notes

  • The attribute previously added to <body> while the mobile menu is open is removed; custom code depending on it must use a new selector to detect the open state.

    0.42.0release notes

  • The mobile menu button uses the .sl-menu-button class instead of a starlight-menu-button wrapper and no longer uses aria-expanded; use :popover-open to style its open state.

    0.42.0release notes

  • Official support drops for Chromium-based browsers before 116, Safari-based browsers before 17.0, and Firefox before 125.

    0.42.0release notes

  • The unused tagline configuration option is removed; configurations that include it can safely drop it without replacement.

    0.42.0release notes

New APIs and options 2

  • Adds a CoffeeScript file icon for the <FileTree> component.

    0.42.4release notes

  • Adds the fluxer icon for developers to use.

    0.42.2release notes

Performance 1

  • Rendering of large nested sidebars is optimized.

    0.42.4release notes

Tooling 1

  • The package is now distributed as JavaScript files with dedicated type declaration files instead of TypeScript source files.

    0.42.0release notes

Fixes and other changes 8

  • Fixes the codePen and node icons slightly extending beyond their bounding box.

    0.42.6release notes

  • Fixes Failed to resolve dependency warnings when running the development server in projects using the Cloudflare adapter.

    0.42.6release notes

  • Adds support for Icelandic.

    0.42.6release notes

  • Fixes a potential issue with icons being cut off in Firefox when pinch-zooming.

    0.42.6release notes

  • Pages that do not import components from @astrojs/starlight/components no longer include styles for Starlight components used on other pages.

    0.42.6release notes

  • Adds support for the Macedonian language.

    0.42.5release notes

  • Fixes .ejs and npm-debug.log files displaying the default file icon.

    0.42.4release notes

  • The sidebar pane no longer has the popover attribute on desktop viewports, preventing it from remaining in a hidden popover visibility state.

    0.42.1release notes

@astrojs/starlight 0.4112 changes

New APIs and options 5

Performance 1

  • Optimizes sidebar data generation logic to speed up sites with large sidebars.

    0.41.11release notes

Fixes and other changes 6

  • Fixes layout issues and prevents anchor links from appearing for hidden headings when markdown.headingLinks is enabled or the AnchorHeading component is used.

    0.41.11release notes

  • Adds missing Expressive Code translations for Arabic, Hindi, Italian, Japanese, Korean, Portuguese, Simplified Chinese, and Traditional Chinese.

    0.41.10release notes

  • Fixes localization of code block UI elements when using the Sätteri Markdown processor.

    0.41.8release notes

  • Fixes processing of code examples in RTL languages when using Astro’s Sätteri Markdown processor.

    0.41.7release notes

  • Fixes support for modifying Zod enums when passing the extend option to docsSchema().

    0.41.4release notes

  • Fixes support for links containing a protocol like mailto: in the sidebar.

    0.41.4release notes