#4149 fa10e87 Thanks @ematipico! - Optimizes rendering of large nested sidebars
#4215 f791de6 Thanks @HiDeoo! - Adds a new seti:coffee icon for CoffeeScript files in the <FileTree> component.
#4215 f791de6 Thanks @HiDeoo! - Fixes <FileTree> icons for .ejs and npm-debug.log files displaying the default file icon.
33e21ec Thanks @HiDeoo! - Fixes a potential page freeze due to table of contents highlighting when a <PageTitle> component override does not render a heading with the required id="_top".fafd989 Thanks @linux-universe! - Add 1 new icon: fluxer
#3572 292fb17 Thanks @HiDeoo! - Distributes package as JavaScript files with dedicated type declaration files instead of TypeScript source files.
#4121 2623ae6 Thanks @delucis! - Simplifies markup for Starlight’s mobile menu toggle
⚠️ Potentially breaking change: If you use a theme plugin, custom styles, or component overrides targeting the MobileMenuToggle button or PageFrame components, you may need to adjust these for the new markup. The button is no longer wrapped in a <starlight-menu-button> custom element and no longer uses the aria-expanded attribute. Instead, you can use the .sl-menu-button class name to target the button and the :popover-open pseudo-class to style the menu open state specifically.
In the following example, custom styles for the menu button are updated for the new approach:
starlight-menu-button button { .sl-menu-button { color: var(--sl-color-text);}
starlight-menu-button[aria-expanded='true'] button { .sl-menu-button:has(~ :popover-open) { color: var(--sl-color-text-accent-high);}See MobileMenuToggle.astro and PageFrame.astro on GitHub for the full source code of the updated components.
#3572 292fb17 Thanks @HiDeoo! - Removes the tagline configuration option, which was never used.
If your configuration included a tagline option, you can safely remove it without any replacement.
#4134 6135f01 Thanks @HiDeoo! - Updates internal @astrojs/mdx, @astrojs/markdown-satteri, and satteri dependencies.
⚠️ BREAKING CHANGE: The following minimum versions are now required:
astro v7.2.10 or later@astrojs/markdown-satteri 0.4.0 or later (if you use it)@astrojs/markdown-remark 7.3.0 or later (if you use it)Please update Starlight and Astro together:
npx @astrojs/upgrade#4121 2623ae6 Thanks @delucis! - Refactors Starlight’s mobile menu toggle to work when JavaScript fails or is disabled
⚠️ BREAKING CHANGE: This release drops official support for Chromium-based browsers prior to version 116 (released August 2023), Safari-based browsers prior to version 17.0 (released September 2023), and Firefox prior to version 125 (released April 2024). You can find a list of currently supported browsers and their versions using this browserslist query.
This change also removes the data-mobile-menu-expanded attribute, which was previously added to <body> while the mobile menu is open. If you have custom code that was depending on this attribute, you will need to update it to use a new selector to check if the mobile menu is open.
In the following example, a custom background colour for the site header while the menu is open is updated for the new approach:
[data-mobile-menu-expanded] header { body:has(sl-sidebar-pane:popover-open) header { background-color: var(--sl-color-bg);}#4167 32a5e29 Thanks @HiDeoo! - Fixes a layout issue and anchor links appearing for hidden headings, e.g. footnote headings, when markdown.headingLinks is enabled or the <AnchorHeading> component is used.
#4148 cdfafd8 Thanks @ematipico! - Optimizes sidebar data generation logic to speed up sites with large sidebars
#4160 88442c3 Thanks @ArmandPhilippot! - Adds the missing translations for Expressive Code in the following locales: ar, hi, it, ja, ko, pt, zh-CN, and zh-TW.
#4159 a0e0ba2 Thanks @trueberryless! - Adds 1 new icon: npmx
#4142 cacbc9f Thanks @alebelcor! - Adds 1 new icon: whatsApp
#4133 3944311 Thanks @delucis! - Internal refactor: numbered id attributes in the <Tabs> component are now page-specific instead of using a global counter
#4138 cd4b665 Thanks @delucis! - Fixes localisation of code block UI elements when using the Sätteri Markdown processor
#3936 712eedd Thanks @miichom! - Fixes support for modifying Zod enums when passing an extend option to Starlight’s docsSchema()
#4092 0896b91 Thanks @delucis! - Fixes support for links containing a protocol like mailto: in the sidebar
#4088 4486ba4 Thanks @delucis! - Simplifies Starlight’s client-side sidebar state persistence script slightly
1686ecc Thanks @timothyjordan! - Keeps keyboard focus inside the mobile menu while it is open, preventing focus moving to hidden interactive elements in page content.#4008 58a3520 Thanks @FrancoKaddour! - Fixes the table of contents overflowing the right edge of the viewport when a custom --sl-content-width value exceeds available space
#4015 bdbfffc Thanks @delucis! - Fixes an issue where aside icons were rendered incorrectly in projects where Astro’s MDX integration had optimization disabled
#3951 1202dd4 Thanks @HiDeoo! - Adds support for Astro v7, drops support for Astro v6.
⚠️ BREAKING CHANGE: Astro v6 is no longer supported. Make sure you update Astro and any other official integrations at the same time as updating Starlight:
npx @astrojs/upgradeCommunity Starlight plugins and Astro integrations may also need to be manually updated to work with Astro v7. If you encounter any issues, please reach out to the plugin or integration author to see if it is a known issue or if an updated version is being worked on.
⚠️ BREAKING CHANGE: This release drops official support for Chromium-based browsers prior to version 111 (released 07 March 2023) and Safari-based browsers prior to version 16.4 (released 27 March 2023). You can find a list of currently supported browsers and their versions using this browserslist query.
#3923 edf2e6b Thanks @Princesseuh! - Adds support for Astro 6.4 and the new Sätteri Markdown processor.
It is now possible to opt into using Astro’s 6.4 Sätteri Markdown processor by installing the @astrojs/markdown-satteri package and configuring it in your astro.config.mjs file:
import { defineConfig } from 'astro/config';import { satteri } from '@astrojs/markdown-satteri';
export default defineConfig({ markdown: { processor: satteri(), },});⚠️ BREAKING CHANGE: The minimum supported version of Astro is now v6.4.5.
Please update Starlight and Astro together:
npx @astrojs/upgradeCommunity Starlight plugins and Astro integrations may also need to be manually updated to work with Sätteri. If you encounter any issues, please reach out to the plugin or integration author to see if it is a known issue or if an updated version is being worked on.
edf2e6b Thanks @Princesseuh! - Updates Expressive Code to version 0.43.1.#3910 dddf405 Thanks @andreialba! - Improves Romanian UI translations
#3924 02f2ce1 Thanks @BouRock! - Improves Turkish UI translations
#3928 11a7ed2 Thanks @delucis! - Updates Pagefind to v1.5 and adds support for Pagefind’s new diacriticSimilarity and metaWeights advanced ranking options
#3927 e944870 Thanks @HiDeoo! - Refactors internal file path handling for Starlight content collections.