#1978 a5ab8cd6 Thanks @kylewlacy! - Add new social icon for Zulip
#1962 2ef19a94 Thanks @torn4dom4n! - Updates Vietnamese UI translations
#1976 5a61f73c Thanks @jsparkdev! - Updates Korean UI translations
#1987 0b8a8439 Thanks @HiDeoo! - Fixes issues with the locale text direction detection mechanism in some environments like WebContainers or Bun.
#1841 ee0cd38a Thanks @HiDeoo! - Adds support for Astro.currentLocale and Astro’s i18n routing.
⚠️ Potentially breaking change: Starlight now configures Astro’s i18n option for you based on its locales config.
If you are currently using Astro’s i18n option as well as Starlight’s locales option, you will need to remove one of these.
In general we recommend using Starlight’s locales, but if you have a more advanced configuration you may choose to keep Astro’s i18n config instead.
#1958 081d1a96 Thanks @delucis! - Allows users to opt into displaying a “Built with Starlight” link in the site footer
#1530 dd64836a Thanks @kevinzunigacuellar! - Adds a new <Badge> component
#1846 2de67039 Thanks @delucis! - Updates @astrojs/mdx to v3 and enables MDX optimization by default
⚠️ Potentially breaking change: MDX optimization speeds up builds (Starlight’s docs are building ~40% faster for example), but restricts some advanced MDX features. See full details in the MDX optimization documentation.
Most Starlight users should be unaffected, but if you are using MDX files outside of Starlight pages with the components prop, you may see issues. You can disable optimization by adding MDX manually to your integrations array in astro.config.mjs:
import { defineConfig } from 'astro/config'; import mdx from '@astrojs/mdx';import starlight from '@astrojs/starlight';
// https://astro.build/configexport default defineConfig({ integrations: [ starlight({ title: 'My docs', // ... }), mdx(), ],});#1735 1a9ab50d Thanks @HiDeoo! - Adds custom styles for <details> and <summary> elements in Markdown content.
#1846 2de67039 Thanks @delucis! - ⚠️ BREAKING CHANGE: The minimum supported version of Astro is now 4.8.6
Please update Astro and Starlight together:
npx @astrojs/upgrade#1871 03bb126b Thanks @delucis! - Adds a blueSky icon and social link option
#1873 13f33b81 Thanks @ekfuhrmann! - Adds 1 new icon: alpine
#1857 32cdfaf0 Thanks @tarikcoskun! - Updates Turkish UI translations
#1736 cfa94a34 Thanks @julien-deramond! - Prevent list items from overflowing Markdown content
#1838 9fe84754 Thanks @delucis! - Adds extra information to the errors thrown by the <Steps> component to help locate misformatted code
#1863 50be60bb Thanks @torn4dom4n! - Update Vietnamese translation
#1837 a33a1223 Thanks @delucis! - Adds three new icons: comment, comment-alt, heart
#1842 c7838636 Thanks @delucis! - Moves the href used in the site title link to Starlight’s route data object. This makes it possible for overrides to change the title link while reusing Starlight’s default component implemenation.
#1840 cb85563c Thanks @MiahaCybersec! - Adds 1 new icon: hackerone
#640 7dc503ea Thanks @HiDeoo! - Adds support for syncing multiple sets of tabs on the same page.
#1620 ca0678ca Thanks @emjio! - Adds support for translating the site title
⚠️ Potentially breaking change: The shape of the title field on Starlight’s internal config object has changed. This used to be a string, but is now an object.
If you are relying on config.title (for example in a custom <SiteTitle> or <Head> component), you will need to update your code. We recommend using the new siteTitle prop available to component overrides:
---import type { Props } from '@astrojs/starlight/props';
// The site title for this page’s language:const { siteTitle } = Astro.props;---#1613 61493e55 Thanks @HiDeoo! - Adds new draft frontmatter option to exclude a page from production builds.
#640 7dc503ea Thanks @HiDeoo! - Updates the default line-height from 1.8 to 1.75. This change avoids having a line height with a fractional part which can cause scripts accessing dimensions involving the line height to get an inconsistent rounded value in various browsers.
If you want to preserve the previous line-height, you can add the following custom CSS to your site:
:root { --sl-line-height: 1.8;}#1720 749ddf85 Thanks @jacobdalamb! - Updates astro-expressive-code dependency to the latest minor release (0.35) and exposes a new @astrojs/starlight/expressive-code/hast module for users who need to use Expressive Code’s version of hast.
This includes a potentially breaking change if you use custom Expressive Code plugins. See the Expressive Code release notes for full details.
#1769 bd5f1cbd Thanks @ncjones! - Adds support for accessing frontmatter data as a variable when using Markdoc
#1788 681a4273 Thanks @dragomano! - Adds Russian translations for Expressive Code labels
#1780 4db6025a Thanks @MiahaCybersec! - Adds 1 new icon: signal
#1785 65009c9c Thanks @dreyfus92! - Adds 5 new icons: node, cloudflare, vercel, netlify and deno
#1786 d05d693a Thanks @delucis! - Fixes type inference for i18n strings added by extending the default schema
#1777 6949404b Thanks @HiDeoo! - Fixes an issue where TypeScript could fail to serialize the frontmatter schema when configured to emit declaration files
#1734 4493dcfa Thanks @delucis! - Refactors <ThemeSelect> custom element logic to improve performance
#1731 f08b0dff Thanks @techfg! - Fixes responding to system color scheme changes when theme is auto
#1793 2616f0c7 Thanks @Mrahmani71! - Updates the Farsi UI translations
#1709 c5cd1811 Thanks @HiDeoo! - Fixes a UI strings translation issue for sites configured with a single non-root language different from English.
#1723 3b29b3ab Thanks @OliverSpeir! - Fixes accessibility by using aria-selected="false" for inactive tabs instead of removing aria-selected="true" in the tablist of Starlight’s <Tabs> component
#1706 f171ac4d Thanks @jorenbroekema! - Fixes some minor type errors
#1622 3a074bad Thanks @SamuelLHuber! - Adds 1 new icon: farcaster
#1616 a86f9b71 Thanks @dragomano! - Updates Russian UI strings
#1698 67b892fd Thanks @liruifengv! - Adds 1 new icon: starlight
#1687 6fa9ea7e Thanks @mingjunlu! - Translates fileTree.directory UI string into Traditional Chinese.
#1614 78fc9042 Thanks @kpodurgiel! - Adds Polish UI translations
#1596 13ed30cd Thanks @HiDeoo! - Adds support for toggling the built-in search modal using the Ctrl+k keyboard shortcut.
#1608 4096e1b7 Thanks @HiDeoo! - Removes nested CSS from the <FileTree> component to prevent a potential warning when using Tailwind CSS.
#1626 67459cb4 Thanks @hippotastic! - Fixes a bundling issue that caused imports from @astrojs/starlight/components to fail when using the config setting expressiveCode: false.
#1584 8851d5cd Thanks @HiDeoo! - Adds 2 new icons: apple and linux.
#1577 0ba77890 Thanks @morinokami! - Translates fileTree.directory UI string into Japanese.
#1593 fa7ed245 Thanks @liruifengv! - Translates fileTree.directory UI string into simplified Chinese.
#1585 bd4e278f Thanks @HiDeoo! - Translates fileTree.directory UI string into French.
#1587 c5794260 Thanks @Eveeifyeve! - Adds 1 new icon: homebrew.
#1568 5f99a71d Thanks @HiDeoo! - Adds support for optionally setting an icon on a <TabItem> component to make it easier to visually distinguish between tabs.
#1308 9a918a5b Thanks @HiDeoo! - Adds <FileTree> component to display the structure of a directory.
#1308 9a918a5b Thanks @HiDeoo! - Adds 144 new file-type icons from the Seti UI icon set, available with the seti: prefix, e.g. seti:javascript.
#1564 d880065e Thanks @delucis! - Adds a <Steps> component for styling more complex guided tasks.
#1308 9a918a5b Thanks @HiDeoo! - Adds 5 new icons: astro, biome, bun, mdx, and pnpm.
8e091147 Thanks @hippotastic! - Updates Expressive Code to v0.33.4 to fix potential race condition bug in Shiki.
#1541 1043052f Thanks @hippotastic! - Updates astro-expressive-code dependency to the latest minor release (0.33).
This unlocks support for word wrap and line numbers, as well as updating the syntax highlighter to the latest Shiki release, which includes new and updated language grammars.
See the Expressive Code release notes for more information including details of potentially breaking changes.