Compare Versions - @astrojs/starlight

npm/@astrojs/starlight/Compare Versions

View on npm

From:→To:

0.41.10

Patch Changes

#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.
#4156 57af92d Thanks @pyxelr! - Adds 1 new icon: hypothesis
#4159 a0e0ba2 Thanks @trueberryless! - Adds 1 new icon: npmx

0.41.9

Patch Changes

#4145 1c90d69 Thanks @pyxelr! - Adds 1 new icon: goodreads

0.41.8

Patch Changes

#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

0.41.7

Patch Changes

#4114 3e486fb Thanks @delucis! - Fixes processing of code examples in RTL languages when using Astro’s Sätteri Markdown processor

0.41.6

Patch Changes

#4102 f1dddc0 Thanks @delucis! - Adds 1 new icon: forgejo

0.41.5

Patch Changes

#4095 bb06434 Thanks @HiDeoo! - Fixes a regression when using a union to extend Starlight’s docsSchema().

0.41.4

Patch Changes

#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

0.41.3

Patch Changes

#3911 1686ecc Thanks @timothyjordan! - Keeps keyboard focus inside the mobile menu while it is open, preventing focus moving to hidden interactive elements in page content.

0.41.2

Patch Changes

#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

0.41.1

Patch Changes

#3967 72e63dc Thanks @HiDeoo! - Adds 2 new icons: link and link-alt.
#3988 ac55cfa Thanks @delucis! - Fixes a dependency resolution issue introduced in Starlight v0.41
#3967 72e63dc Thanks @HiDeoo! - Optimizes the icons of Markdown asides.

0.41.0

Minor Changes

#3951 1202dd4 Thanks @HiDeoo! - Adds support for Astro v7, drops support for Astro v6.

Upgrade Astro and dependencies

⚠️ 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/upgrade
```
Community 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.

Patch Changes

#3953 a935d33 Thanks @HiDeoo! - Fixes Starlight Markdown processing being potentially applied to files that should not be processed.

0.40.0

Minor Changes

#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:
```
// astro.config.mjs

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/upgrade
```
Community 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.

Patch Changes

#3923 edf2e6b Thanks @Princesseuh! - Updates Expressive Code to version 0.43.1.

0.39.3

Patch Changes

#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.

0.39.2

Patch Changes

#3890 2d05e18 Thanks @tats-u! - Fixes CSS selector for text-autospace styles in Chromium browsers

0.39.1

Patch Changes

#3885 010eed1 Thanks @ArmandPhilippot! - Fixes the version mentioned in an error message related to autogenerated sidebar groups support.
#3887 b3c6990 Thanks @delucis! - Adds 13 new icons: clock, desktop, mobile-android, window, database, server, code-branch, notes, question, question-circle, analytics, padlock, and solidjs.

0.39.0

Minor Changes

#3618 dcf6d09 Thanks @HiDeoo! - ⚠️ BREAKING CHANGE: This release changes how autogenerated links work in Starlight’s sidebar configuration.

If you have sidebar groups using the autogenerate key, you must now wrap that configuration in an items array:
```
{
    label: 'My group',
-   autogenerate: { directory: 'some-dir' },
+   items: [{ autogenerate: { directory: 'some-dir' } }],
}
```
This change unlocks the possibility to mix autogenerated links and other links in a single group, for example:
```
{
  label: 'Mixed group',
  items: [
    'example-page',
    { autogenerate: { directory: 'examples' } },
    { label: 'More examples', link: 'https://example.com' },
  ],
}
```
This release also updates the shape of autogenerated sidebar entries in route data. Autogenerated links and groups in Astro.locals.starlightRoute.sidebar now include an autogenerate object with the configured directory value:
```
{
  type: 'link',
  label: 'Example',
  href: '/examples/example/',
  isCurrent: false,
  autogenerate: { directory: 'examples' }
}
```
#3618 dcf6d09 Thanks @HiDeoo! - ⚠️ BREAKING CHANGE: This release changes the default collapsed state of autogenerated sidebar subgroups.

Autogenerated subgroups no longer inherit the collapsed value from their parent group. They are now expanded by default unless explicitly configured with autogenerate.collapsed.

If your sidebar configuration relies on a collapsed parent group to also collapse its autogenerated subgroups, update your configuration to set autogenerate.collapsed to true:
```
{
  label: 'Reference',
  collapsed: true,
  items: [
-   { autogenerate: { directory: 'reference' } },
+   { autogenerate: { directory: 'reference', collapsed: true } },
  ],
}
```
#3845 4d755f5 Thanks @delucis! - Adds a <link rel="alternate" hreflang="x-default" href="..."> tag pointing to the default locale in multilingual sites. The x-default alternate is used as a signal of which language to fall back to if no other is available. Learn more in Google’s SEO localization docs.
#3862 ec70630 Thanks @itrew! - Makes spacing of items in nested lists more consistent
#3872 417a66c Thanks @tats-u! - Enables the CSS property text-autospace in Chinese and Japanese documents.

If you would prefer to disable autospacing in Chinese and Japanese pages, you can add the following custom CSS to your site:
```
[lang]:where(:lang(zh, ja)) {
  text-autospace: initial;
}
```
#3797 9764ebd Thanks @delucis! - Avoids the risk of layout shift when users expand and collapse sidebar groups

This release can introduce additional padding to the site sidebar on certain devices to reserve space for scrollbars. You may wish to inspect your site sidebar visually when upgrading.

If you would prefer to keep the previous styling, you can add the following custom CSS to your site:
```
.sidebar-pane {
  scrollbar-gutter: auto;
}
```
#3858 6672c35 Thanks @delucis! - Updates i18next, used for Starlight’s localization APIs, from v23 to v26

There should not be any user-facing changes from this update

0.38.5

Patch Changes

#3854 ccf6000, #3877 47451bc Thanks @delucis! - Updates internal dependencies

0.38.4

Patch Changes

#3828 342038b Thanks @MangelMaxime! - Fixes aside styling when used without any content
#3853 563e11b Thanks @delucis! - Fixes a type-checking issue for users on newer versions of TypeScript

0.38.3

Patch Changes

#3799 313611b Thanks @JosefJezek! - Improves Czech UI translations
#3770 6e7bed1 Thanks @gameroman! - Adds examples to the inline documentation for title in the Starlight configuration object
#3801 fedd48b Thanks @delucis! - Fixes missing draft content warning in dev on pages using the hero layout

0.38.2

Patch Changes

#3759 f24ce99 Thanks @MilesChou! - Fixes an issue where monolingual sites using a region-specific locale (e.g., zh-TW) as the default would incorrectly display base language translations (e.g., zh Simplified Chinese) instead of the region-specific ones (e.g., zh-TW Traditional Chinese).
#3768 a4c6c20 Thanks @delucis! - Improves performance of sidebar generation for sites with very large sidebars

0.38.1

Patch Changes

#3751 fb955ff Thanks @pyxelr! - Fixes a regression causing global tableOfContents config to be ignored

0.38.0

Minor Changes

#3644 0d2e7ed Thanks @HiDeoo! - Adds support for Astro v6, drops support for Astro v5.

Upgrade Astro and dependencies

⚠️ BREAKING CHANGE: Astro v5 is no longer supported. Make sure you update Astro and any other official integrations at the same time as updating Starlight:
```
npx @astrojs/upgrade
```
Community Starlight plugins and Astro integrations may also need to be manually updated to work with Astro v6. 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.

Update your collections

⚠️ BREAKING CHANGE: Drops support for content collections backwards compatibility.

In Astro 5.x, projects could delay upgrading to the new Content Layer API introduced for content collections because of some existing automatic backwards compatibility that was not previously behind a flag. This meant that it was possible to upgrade from Astro 4 to Astro 5 without updating your content collections, even if you had not enabled the legacy.collections flag. Projects would continue to build, and no errors or warnings would be displayed.

Astro v6.0 now removes this automatic legacy content collections support, along with the legacy.collections flag.

If you experience content collections errors after updating to v6, check your project for any removed legacy features that may need updating to the Content Layer API. See the Starlight v0.30.0 upgrade guide for detailed instructions on upgrading legacy collections to the new Content Layer API.

If you are unable to make any changes to your collections at this time, including Starlight's default docs and i18n collections, you can enable the legacy.collectionsBackwardsCompat flag to upgrade to v6 without updating your collections. This temporary flag preserves some legacy v4 content collections features, and will allow you to keep your collections in their current state until the legacy flag is no longer supported.
#3704 375edcc Thanks @florian-lefebvre! - Fixes autocomplete for components exported from @astrojs/starlight/components/*

⚠️ Potentially breaking change: This change moves some files used in Starlight’s component internals out of the components/ directory. Direct use of these files was not and is not officially supported. If you previously imported TableOfContents/starlight-toc.ts, TableOfContents/TableOfContentsList.astro, Icons.ts, or SidebarPersistState.ts, please review your code when updating.
#3729 3642625 Thanks @delucis! - Improves Starlight’s default body font stack to better support languages such as Chinese, Japanese, and Korean on Windows. For most users there should be no visible change.

If you would prefer to keep the previous font stack, you can add the following custom CSS to your site:
```
:root {
  --sl-font-system: ui-sans-serif, system-ui, 'Segoe UI', Roboto,
    'Helvetica Neue', Arial, 'Noto Sans', sans-serif, 'Apple Color Emoji',
    'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
}
```
#3598 fff38d5 Thanks @HiDeoo! - Makes hover styles consistent in Starlight’s navigation bar

Previously, the social icon links and language/theme switchers in Starlight’s navigation bar, dimmed on hover. After this change, they now increase in contrast on hover instead. This matches hover behavior elsewhere, for example in the sidebar, table of contents, or search button.

⚠️ Potentially breaking change: this is a subtle change to the hover style colors. If you want to preserve the previous styling, you can add the following custom CSS to your site:
```
starlight-theme-select label,
starlight-lang-select label {
  color: var(--sl-color-gray-1);

  &:hover {
    color: var(--sl-color-white);
  }
}

.social-icons a:hover {
  color: var(--sl-color-text-accent);
  opacity: 0.66;
}
```

0.37.7

Patch Changes

#3726 8a09b60 Thanks @delucis! - Fixes an issue using components containing scripts inside Starlight’s steps component in versions of Astro >= 5.16.9

0.37.6

Patch Changes

#3645 a562096 Thanks @mschoeffmann! - Adds icons for Chrome, Edge, Firefox, and Safari

0.37.5

Patch Changes

#3675 0ba556d Thanks @controversial! - Excludes the accessible labels for heading anchor links from Pagefind results

0.37.4

Patch Changes

#3534 703fab0 Thanks @HiDeoo! - Fixes support for running builds when npx is unavailable.

Previously, Starlight would spawn a process to run the Pagefind search indexing binary using npx. On platforms where npx isn’t available, this could cause issues. Starlight now runs Pagefind using its Node.js API to avoid a separate process. As a side effect, you may notice that logging during builds is now less verbose.
#3656 a0e6368 Thanks @delucis! - Fixes several edge cases in highlighting the current page heading in Starlight’s table of contents
#3663 00cbf00 Thanks @lines-of-codes! - Adds Thai language support
#3658 ac79329 Thanks @delucis! - Avoids adding redundant aria-current="false" attributes to sidebar entries
#3382 db295c2 Thanks @trueberryless! - Fixes an issue where the mobile table of contents is unable to find the first heading when a page has a tall banner.

0.37.3

Patch Changes

#3648 292666c Thanks @maxchang3! - Prevents unwanted font size adjustments on iOS after orientation changes.

0.37.2

Patch Changes

#3647 9f4efc3 Thanks @gerstenbergit! - Adds Greek language support

0.37.1

Patch Changes

#3603 30f6e7f Thanks @delucis! - Fixes support for providing an absolute URL to Starlight’s favicon configuration option

0.37.0

Minor Changes

#3491 28810f0 Thanks @JusticeMatthew! - Changes text overflow styling in Markdown content

⚠️ Potentially breaking change: This release switches the overflow-wrap CSS style for common elements to break-word. In most cases, there should be little visual impact, but this change can impact how layouts with implicit sizing (such as tables) look, improving legibility in how words wrap.

If you want to preserve the previous styling, you can add the following custom CSS to your site:
```
p, h1, h2, h3, h4, h5, h6, code {
  overflow-wrap: anywhere;
}
```
#3351 239698c Thanks @HiDeoo! - Ensures that Starlight CSS layer order is predictable in custom pages using the <StarlightPage> component.

Previously, due to how import order works in Astro, the <StarlightPage> component had to be the first import in custom pages to set up cascade layers used internally by Starlight to manage the order of its styles.

With this change, this restriction no longer applies and Starlight’s styles will be applied correctly regardless of the import order of the <StarlightPage> component.
#3521 ca7b771 Thanks @shubham-padia! - Fixes an issue where a vertical scrollbar could be displayed on the Starlight <Tabs> component when zooming the page

⚠️ Potentially breaking change: The <Tabs> component no longer uses margin-bottom and border-bottom to highlight the current tab. This is now done with a box-shadow. If you have custom styling for your tabs, you may need to update it.

If you want to preserve the previous styling, you can add the following custom CSS to your site:
```
starlight-tabs .tab {
  margin-bottom: -2px;
}

starlight-tabs .tab > [role='tab'] {
  border-bottom: 2px solid var(--sl-color-gray-5);
  box-shadow: none;
}

starlight-tabs .tab [role='tab'][aria-selected='true'] {
  border-color: var(--sl-color-text-accent);
}
```
#3549 1cf50eb Thanks @jacobdalamb! - Updates the default sans-serif system font stack, dropping support for the -apple-system and BlinkMacSystemFont font names used in older browsers. These are no longer needed in browsers officially supported by Starlight.

If you still need to support older browsers, you can add the following custom CSS to your site:
```
:root {
  --sl-font-system: ui-sans-serif, system-ui, -apple-system,
    BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial,
    'Noto Sans', sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji',
    'Segoe UI Symbol', 'Noto Color Emoji';
}
```
#3332 f61f99d Thanks @HiDeoo! - Adds a new markdown.processedDirs configuration option to specify additional directories where files should be processed by Starlight’s Markdown pipeline.

By default, Starlight’s processing only applies to Markdown and MDX content loaded using Starlight’s docsLoader(). This new option allows to extend this processing to other directories, which can be useful if you are rendering content from a custom content collection using the <StarlightPage> component and expect Starlight’s Markdown processing to be applied to that content as well.

0.36.3

Patch Changes

#3555 547dc30 Thanks @Its-Just-Nans! - Improves the error message thrown when using a file in the public/ directory with Starlight’s customCss configuration option
#3496 b78fda4 Thanks @delucis! - Fixes invalid <head> output when configuration is missing:
- Omits <meta property="og:description" /> if Starlight’s description option is unset
- Omits <link rel="canonical" /> and <meta property="og:url" /> if Astro’s site option is unset
#3511 8727df1 Thanks @astrobot-houston! - Updates the seti:gitlab icon to match latest version from Seti UI Icons

0.36.2

Patch Changes

#3500 7700456 Thanks @delucis! - This is the first release published with OIDC trusted publishing.
#3484 620fb38 Thanks @gboubeta-uvigo! - Improves Spanish UI translations

0.36.1

Patch Changes

#3479 2fec483 Thanks @gboubeta-uvigo! - Updates Galician UI translations
#3457 c6c0c51 Thanks @HiDeoo! - Deduplicates sitemap link tags in the head.

When enabling sitemap in Starlight, a <link rel="sitemap" href="/sitemap-index.xml"> tag is automatically added to the head of each page. Manually specifying sitemap link tags using the Starlight head configuration option or the head frontmatter field will now override the default sitemap link tag added by Starlight.

This change ensures that users manually adding the @astrojs/sitemap integration to the Astro integrations array for more fine-grained control over sitemap generation and also using the filenameBase integration option can customize the sitemap link tag in the head.
#3448 1fc7501 Thanks @dionysuzx! - Enlarges the Farcaster icon to better match other social icons
#3473 07204dd Thanks @gboubeta! - Fixes a typo in Galician table of contents label

0.36.0

Minor Changes

#3427 c3b2d0f Thanks @delucis! - Fixes styling of labels that wrap across multiple lines in <Tabs> component

⚠️ Potentially breaking change: Tab labels now have a narrower line-height and additional vertical padding. If you have custom CSS targetting the <Tabs> component, you may want to double check the visual appearance of your tabs when updating.

If you want to preserve the previous styling, you can add the following custom CSS to your site:
```
.tab > [role='tab'] {
  line-height: var(--sl-line-height);
  padding-block: 0;
}
```
#3380 3364af3 Thanks @HiDeoo! - Makes head entry parsing stricter in Starlight config and content frontmatter.

⚠️ Potentially breaking change: Previously Starlight would accept a head entry for a meta tag defining some content which generates invalid HTML as <meta> is a void element which cannot have any child nodes. Now, it is an error to define a meta tag including some content.

If you see errors after updating, look for head entries in the Starlight configuration in the astro.config.mjs file or in the frontmatter of your content files that include a content property for a meta tag. To fix the error, move the content property to the attrs object with at least an additional attribute to identify the kind of metadata it represents:
```
head: {
  tag: 'meta',
- content: 'foo',
  attrs: {
    name: 'my-meta',
+   content: 'foo',
  },
},
```
#3340 2018c31 Thanks @HiDeoo! - Adds missing vertical spacing between Markdown content and UI Framework components using client directives.

⚠️ Potentially breaking change: By default, Starlight applies some vertical spacing (--sl-content-gap-y) between Markdown content blocks. This change introduces similar spacing between Markdown content blocks and UI Framework components using client directives which was not present before.

If you were relying on the previous behavior, you can manually override the spacing by manually specifying the top margin on the component using custom CSS, e.g. by relying on a CSS class to target the component.
```
.my-custom-component {
  margin-top: 0;
}
```

Patch Changes

#3423 a0d0670 Thanks @andersk! - Fixes HTML validity in sidebar groups by ensuring <summary> is the first child of <details>

0.35.3

Patch Changes

#3416 fcc0633 Thanks @randomguy-2650! - Updates German UI translations to be more idiomatic.
#1640 d1b3828 Thanks @hippotastic! - Refactors various internal systems, improving code quality and maintainability.
#3421 97e8103 Thanks @andersk! - Removes an invalid value attribute from the language and theme selectors
#3422 9200fac Thanks @andersk! - Refactors collapsible sidebar sections and “on this page” dropdown to use <span> instead of <div>

0.35.2

Patch Changes

#3341 10f6fe2 Thanks @HiDeoo! - Prevents potential build issues with the Astro Cloudflare adapter due to the dependency on Node.js builtins.
#3327 bf58c60 Thanks @delucis! - Fixes a routing bug for docs pages with a slug authored with non-normalized composition. This could occur for filenames containing diacritics in some circumstances, causing 404s.

0.35.1

Patch Changes

#3325 4cf28f2 Thanks @mniinio! - Adds Finnish language support

0.35.0

Minor Changes

#2261 778b743 Thanks @shubham-padia! - Adds support for using any of Starlight’s built-in icons in asides.
#3272 e7fe267 Thanks @delucis! - Adds a new generateId option to Starlight’s docsLoader()

This enables overriding the default sluggifier used to convert content filenames to URLs.
#3276 3917b20 Thanks @delucis! - Excludes banner content from search results

Previously, content set in banner in page frontmatter was indexed by Starlight’s default search provider Pagefind. This could cause unexpected search results, especially for sites setting a common banner content on multiple pages. Starlight’s default Banner component is now excluded from search indexing.

This change does not impact Banner overrides using custom components.
#3266 1161af0 Thanks @HiDeoo! - Adds support for custom HTML attributes on autogenerated sidebar links using the autogenerate.attrs option.
#3274 80ccff7 Thanks @HiDeoo! - Fixes an issue where some Starlight remark and rehype plugins were transforming Markdown and MDX content in non-Starlight pages.

⚠️ BREAKING CHANGE:

Previously, some of Starlight’s remark and rehype plugins, most notably the plugin transforming Starlight's custom Markdown syntax for rendering asides, were applied to all Markdown and MDX content. This included content from individual Markdown pages and content from content collections other than the docs collection used by Starlight.

This change restricts the application of Starlight’s remark and rehype plugins to only Markdown and MDX content loaded using Starlight's docsLoader(). If you were relying on this behavior, please let us know about your use case in the dedicated #starlight channel in the Astro Discord or by opening an issue.

Patch Changes

#3266 1161af0 Thanks @HiDeoo! - Ensures invalid sidebar group configurations using the attrs option are properly reported as a type error.

Previously, invalid sidebar group configurations using the attrs option were not reported as a type error but only surfaced at runtime. This change is only a type-level change and does not affect the runtime behavior of Starlight which does not support the attrs option for sidebar groups.
#3274 80ccff7 Thanks @HiDeoo! - Prevents Starlight remark and rehype plugins from transforming Markdown and MDX content when using the Astro renderMarkdown() content loader API.

0.34.8

Patch Changes

#3306 21fcd94 Thanks @HiDeoo! - Fixes a regression in Starlight version 0.34.5 that caused multilingual sites with a default locale explicitly set to root to report a configuration error.

0.34.7

Patch Changes

#3298 7bd02e3 Thanks @HiDeoo! - Fixes a potential issue with absolutePathToLang() plugin API not handling paths with spaces correctly.

0.34.6

Patch Changes

#3293 88f0d34 Thanks @HiDeoo! - Fixes an issue preventing to override the slug of a page with the slug frontmatter property using the / value.

0.34.5

Patch Changes

#3282 7680e87 Thanks @alvinometric! - Moves padding of <main> element to a --sl-main-pad CSS custom property to simplify setting custom values
#3288 131371e Thanks @HiDeoo! - Fixes a potential configuration issue for multilingual sites with a default language including a regional subtag.

0.34.4

Patch Changes

#3205 95d124a Thanks @sgalcheung! - Fixes an issue preventing to use the <StarlightPage> component when the docs content collection that Starlight uses does not exist.
#3206 e6ea584 Thanks @HiDeoo! - Fixes a text selection issue for heading with a clickable anchor link when using double click to select text in Chrome and Safari.
#3233 3064c40 Thanks @torn4dom4n! - Updates Vietnamese UI translations.
#3248 16c1239 Thanks @HiDeoo! - Prevents icons in the <Card> component from being shrunk in some narrow viewports.
#3225 21b93b8 Thanks @randomguy-2650! - Updates German UI translations

0.34.3

Patch Changes

#3058 274cc06 Thanks @techfg! - Fixes display of focus indicator around site title
#3181 449c822 Thanks @HiDeoo! - Fixes an issue where all headings in Markdown and MDX content were rendered with a clickable anchor link, even in non-Starlight pages.
#3168 ca693fe Thanks @jsparkdev! - Updates Korean langage support with improvements and missing translations

0.34.2

Patch Changes

#3153 ea31f46 Thanks @SuperKXT! - Fixes hover styles for highlighted directory in FileTree component.
#2905 b5232bc Thanks @HiDeoo! - Fixes a potential issue for projects with dynamic routes added by an user, an Astro integration, or a Starlight plugin where some styles could end up being missing.
#3165 80a7871 Thanks @KianNH! - Increases maxBuffer for an internal spawnSync() call to support larger Git commit histories when using Starlight's lastUpdated feature.
#3158 d1f3c8b Thanks @heisenberg0924! - Adds Hungarian language support

0.34.1

Patch Changes

#3140 f6eb1d5 Thanks @HiDeoo! - Fixes a text selection issue for heading with a clickable anchor link when using double or triple click to select text.
#3148 dc8b6d5 Thanks @HiDeoo! - Fixes a regression of the Starlight icon color when using the credits configuration option.

0.34.0

Minor Changes

#2322 f14eb0c Thanks @HiDeoo! - Groups all of Starlight's CSS declarations into a single starlight cascade layer.

This change allows for easier customization of Starlight's CSS as any custom unlayered CSS will override the default styles. If you are using cascade layers in your custom CSS, you can use the @layer CSS at-rule to define the order of precedence for different layers including the ones used by Starlight.

We recommend checking your site’s appearance when upgrading to make sure there are no style regressions caused by this change.
#3122 3a087d8 Thanks @delucis! - Removes default attrs and content values from head entries parsed using Starlight’s schema.

Previously when adding head metadata via frontmatter or user config, Starlight would automatically add values for attrs and content if not provided. Now, these properties are left undefined.

This makes it simpler to add tags in route middleware for example as you no longer need to provide empty values for attrs and content:
```
head.push({
  tag: 'style',
  content: 'div { color: red }'
- attrs: {},
});
head.push({
  tag: 'link',
- content: ''
  attrs: { rel: 'me', href: 'https://example.com' },
});
```
This is mostly an internal API but if you are overriding Starlight’s Head component or processing head entries in some way, you may wish to double check your handling of Astro.locals.starlightRoute.head is compatible with attrs and content potentially being undefined.
#3033 8c19678 Thanks @delucis! - Adds support for generating clickable anchor links for headings.

By default, Starlight now renders an anchor link beside headings in Markdown and MDX content. A new <AnchorHeading> component is available to achieve the same thing in custom pages built using <StarlightPage>.

If you want to disable this new Markdown processing set the markdown.headingLinks option in your Starlight config to false:
```
starlight({
  title: 'My docs',
  markdown: {
    headingLinks: false,
  },
}),
```
⚠️ BREAKING CHANGE: The minimum supported version of Astro is now v5.5.0.

Please update Starlight and Astro together:
```
npx @astrojs/upgrade
```

#2322 f14eb0c Thanks @HiDeoo! - Removes Shiki css-variables theme fallback.

⚠️ BREAKING CHANGE:

Previously, Starlight used to automatically provide a fallback theme for Shiki, the default syntax highlighter built into Astro if the configured Shiki theme was not github-dark.

This fallback was only relevant when the default Starlight code block renderer, Expressive Code, was disabled and Shiki was used. Starlight no longer provides this fallback.

If you were relying on this behavior, you now manually need to update your Astro configuration to use the Shiki css-variables theme to match the previous behavior.

import { defineConfig } from 'astro/config';

export default defineConfig({
+ markdown: {
+   shikiConfig: {
+     theme: 'css-variables',
+   },
+ },
});

Additionally, you can use custom CSS to control the appearance of the code blocks. Here are the previously used CSS variables for the fallback theme:

:root {
  --astro-code-foreground: var(--sl-color-white);
  --astro-code-background: var(--sl-color-gray-6);
  --astro-code-token-constant: var(--sl-color-blue-high);
  --astro-code-token-string: var(--sl-color-green-high);
  --astro-code-token-comment: var(--sl-color-gray-2);
  --astro-code-token-keyword: var(--sl-color-purple-high);
  --astro-code-token-parameter: var(--sl-color-red-high);
  --astro-code-token-function: var(--sl-color-red-high);
  --astro-code-token-string-expression: var(--sl-color-green-high);
  --astro-code-token-punctuation: var(--sl-color-gray-2);
  --astro-code-token-link: var(--sl-color-blue-high);
}

Patch Changes

#3118 77a1104 Thanks @delucis! - Fixes passing imported SVGs to the frontmatter prop of the <StarlightPage> component in Astro ≥5.7.0

0.33.2

Patch Changes

#3090 fc3ffa8 Thanks @delucis! - Updates internal @astrojs/mdx, @astrojs/sitemap, and astro-expressive-code dependencies
#3109 b5cc1b4 Thanks @dhruvkb! - Updates Expressive Code to v0.41.1

0.33.1

Patch Changes

#3088 1885049 Thanks @HiDeoo! - Fixes a regression in Starlight version 0.33.0 that caused the description and links to language alternates for multilingual websites to be missing from the <head> of the page.
#3065 463adf5 Thanks @HiDeoo! - Updates the social configuration option TSDoc example to match the shape of the expected value.

0.33.0

Minor Changes

#3026 82deb84 Thanks @HiDeoo! - Fixes a potential list styling issue if the last element of a list item is a <script> tag.

⚠️ BREAKING CHANGE:

This release drops official support for Chromium-based browsers prior to version 105 (released 30 August 2022) and Firefox-based browsers prior to version 121 (released 19 December 2023). You can find a list of currently supported browsers and their versions using this browserslist query.

With this release, Starlight-generated sites will still work fine on those older browsers except for this small detail in list item styling, but future releases may introduce further breaking changes for impacted browsers, including in patch releases.
#3025 f87e9ac Thanks @delucis! - Makes social configuration more flexible.

⚠️ BREAKING CHANGE: The social configuration option has changed syntax. You will need to update this in astro.config.mjs when upgrading.

Previously, a limited set of platforms were supported using a shorthand syntax with labels built in to Starlight. While convenient, this approach was less flexible and required dedicated code for each social platform added.

Now, you must specify the icon and label for each social link explicitly and you can use any of Starlight’s built-in icons for social links.

The following example shows updating the old social syntax to the new:
```
- social: {
-   github: 'https://github.com/withastro/starlight',
-   discord: 'https://astro.build/chat',
- },
+ social: [
+   { icon: 'github', label: 'GitHub', href: 'https://github.com/withastro/starlight' },
+   { icon: 'discord', label: 'Discord', href: 'https://astro.build/chat' },
+ ],
```
#2927 c46904c Thanks @HiDeoo! - Adds the head route data property which contains an array of all tags to include in the <head> of the current page.

Previously, the <Head> component was responsible for generating a list of tags to include in the <head> of the current page and rendering them. This data is now available as Astro.locals.starlightRoute.head instead and can be modified using route data middleware. The <Head> component now only renders the tags provided in Astro.locals.starlightRoute.head.
#2924 6a56d1b Thanks @HiDeoo! - ⚠️ BREAKING CHANGE: Ensures that the <Badge> and <Icon> components no longer render with a trailing space.

In Astro, components that include styles render with a trailing space which can prevent some use cases from working as expected, e.g. when using such components inlined with text. This change ensures that the <Badge> and <Icon> components no longer render with a trailing space.

If you were previously relying on that implementation detail, you may need to update your code to account for this change. For example, considering the following code:
```
<Badge text="New" />
Feature
```
The rendered text would previously include a space between the badge and the text due to the trailing space automatically added by the component:
```
New Feature
```
Such code will now render the badge and text without a space:
```
NewFeature
```
To fix this, you can add a space between the badge and the text:
```
- <Badge text="New" />Feature
+ <Badge text="New" /> Feature
```
#2727 7c8fa30 Thanks @techfg! - Updates mobile menu toggle styles to display a close icon while the menu is open

Patch Changes

#2927 c46904c Thanks @HiDeoo! - Fixes an issue where overriding the canonical URL of a page using the head configuration option or head frontmatter field would strip any other <link> tags from the <head>.
#2927 c46904c Thanks @HiDeoo! - Fixes an issue where generated canonical URLs would include a trailing slash when using the trailingSlash Astro option is set to 'never'.
#3025 f87e9ac Thanks @delucis! - Fixes Starlight’s autogenerated <meta name="twitter:site"> tags when a Twitter link is set in social config. Previously these incorrectly rendered content="/username" and now correctly render content="@username".

0.32.6

Patch Changes

#3030 5bdf139 Thanks @trueberryless! - Updates the type of the isFallback field in route data from true to boolean, keeping it optional but allowing false as a possible value.
#3018 188b8cf Thanks @trueberryless! - Adds validation for user config routeMiddleware so it does not conflict with Astro's middleware.

0.32.5

Patch Changes

#3021 e3f881e Thanks @jsparkdev! - Updates Korean language support
#3020 58e3e84 Thanks @ayoayco! - Add SourceHut social icon
#3013 5b599dd Thanks @oluwatobiss! - Adds Substack icon to social links list

0.32.4

Patch Changes

#2994 ca4ec8b Thanks @XREvo! - Fixes default ranking of merged indexes when using multi-site search
#2969 4682c7a Thanks @webpro! - Add npm social icon

0.32.3

Patch Changes

#2955 77b6a41 Thanks @trueberryless! - Adds 5 new icons: figma, sketch, vim, vscode, and zed.
#2961 da57fab Thanks @ematipico! - Adds 1 new icon: jetbrains.

0.32.2

Patch Changes

#2926 c0170fd Thanks @resoltico! - Adds Latvian language support
#2918 790c000 Thanks @HiDeoo! - Fixes a trailing slash inconsistency in generated sidebar links when using the trailingSlash: 'ignore' Astro option (the default) between internal and auto-generated links. Starlight behavior for this configuration value is to use a trailing slash as many common hosting providers redirect to URLs with a trailing slash by default.

0.32.1

Patch Changes

#2904 ec5ca59 Thanks @HiDeoo! - Fixes an issue preventing the use of rewrites.

0.32.0

Minor Changes

#2390 f493361 Thanks @delucis! - Moves route data to Astro.locals instead of passing it down via component props

⚠️ Breaking change: Previously, all of Starlight’s templating components, including user or plugin overrides, had access to a data object for the current route via Astro.props. This data is now available as Astro.locals.starlightRoute instead.

To update, refactor any component overrides you have:
- Remove imports of @astrojs/starlight/props, which is now deprecated.
- Update code that accesses Astro.props to use Astro.locals.starlightRoute instead.
- Remove any spreading of {...Astro.props} into child components, which is no longer required.
In the following example, a custom override for Starlight’s LastUpdated component is updated for the new style:
```
---
import Default from '@astrojs/starlight/components/LastUpdated.astro';
- import type { Props } from '@astrojs/starlight/props';

- const { lastUpdated } = Astro.props;
+ const { lastUpdated } = Astro.locals.starlightRoute;

const updatedThisYear = lastUpdated?.getFullYear() === new Date().getFullYear();
---

{updatedThisYear && (
-   <Default {...Astro.props}><slot /></Default>
+   <Default><slot /></Default>
)}
```
Community Starlight plugins may also need to be manually updated to work with Starlight 0.32. If you encounter any issues, please reach out to the plugin author to see if it is a known issue or if an updated version is being worked on.
#2578 f895f75 Thanks @HiDeoo! - Deprecates the Starlight plugin setup hook in favor of the new config:setup hook which provides the same functionality.

⚠️ BREAKING CHANGE:

The Starlight plugin setup hook is now deprecated and will be removed in a future release. Please update your plugins to use the new config:setup hook instead.
```
export default {
  name: 'plugin-with-translations',
  hooks: {
-   'setup'({ config }) {
+   'config:setup'({ config }) {
      // Your plugin configuration setup code
    },
  },
};
```
#2578 f895f75 Thanks @HiDeoo! - Exposes the built-in localization system in the Starlight plugin config:setup hook.

⚠️ BREAKING CHANGE:

This addition changes how Starlight plugins add or update translation strings used in Starlight’s localization APIs. Plugins previously using the injectTranslations() callback function from the plugin config:setup hook should now use the same function available in the i18n:setup hook.
```
export default {
  name: 'plugin-with-translations',
  hooks: {
-   'config:setup'({ injectTranslations }) {
+   'i18n:setup'({ injectTranslations }) {
      injectTranslations({
        en: {
          'myPlugin.doThing': 'Do the thing',
        },
        fr: {
          'myPlugin.doThing': 'Faire le truc',
        },
      });
    },
  },
};
```
#2858 2df9d05 Thanks @XREvo! - Adds support for Pagefind’s multisite search features
#2578 f895f75 Thanks @HiDeoo! - Adds a new HookParameters utility type to get the type of a plugin hook’s arguments.
#2578 f895f75 Thanks @HiDeoo! - Adds a new useTranslations() callback function to the Starlight plugin config:setup hook to generate a utility function to access UI strings for a given language.
#2578 f895f75 Thanks @HiDeoo! - Adds a new absolutePathToLang() callback function to the Starlight plugin config:setup to get the language for a given absolute file path.

Patch Changes

#2848 9b32ba9 Thanks @HiDeoo! - Fixes styling of filter and metadata elements in Pagefind search UI.

0.31.1

Patch Changes

#2805 ed6f9fd Thanks @HiDeoo! - Exposes the StarlightIcon TypeScript type referencing the names of Starlight’s built-in icons.

0.31.0

Minor Changes

#2777 88f4214 Thanks @hippotastic! - Updates astro-expressive-code dependency to the latest version (0.40).

This includes an update to the latest Shiki version (1.26.1), providing access to all current Shiki themes and syntax highlighting languages, and adding the config options shiki.engine, shiki.bundledLangs, shiki.langAlias and removeUnusedThemes. It also adds new style variants to the optional collapsible sections plugin.

See the Expressive Code release notes for full details.
#2736 29a885b Thanks @delucis! - ⚠️ BREAKING CHANGE: The minimum supported version of Astro is now 5.1.5

Please update Astro and Starlight together:
```
npx @astrojs/upgrade
```
#2728 e187383 Thanks @delucis! - Updates minimum Pagefind dependency to v1.3.0, sets new defaults for Pagefind’s ranking options, and adds support for manually configuring the ranking options

The new ranking option defaults have been evaluated against Starlight’s own docs to improve the quality of search results. See “Customize Pagefind's result ranking” for more details about how they work.
#157 23bf960 Thanks @tony-sull! - Adds a print stylesheet to improve the appearance of Starlight docs pages when printed
#2728 e187383 Thanks @delucis! - Fixes Pagefind logging to respect the Astro log level. When using Astro’s --verbose or --silent CLI flags, these are now respected by Pagefind as well.

Patch Changes

#2792 412effb Thanks @dhruvkb! - Uses semantic var(--sl-color-hairline) for the page sidebar border instead of var(--sl-color-gray-6). This is visually the same as previously but makes it easier to override the hairline color consistently across a site.
#2736 29a885b Thanks @delucis! - Updates internal dependencies @astrojs/sitemap and @astrojs/mdx to the latest versions
#2782 d9d415b Thanks @delucis! - Fixes a documentation link in the JSDoc comment for the StarlightExpressiveCodeOptions type
#2708 442c819 Thanks @delucis! - Fixes colour contrast correction in code blocks

0.30.6

Patch Changes

#2722 0b206d3 Thanks @techfg! - Fixes display of long site title on mobile
#2762 7ab1576 Thanks @HiDeoo! - Prevents the header title from being translated by automatic translation systems.

0.30.5

Patch Changes

#2757 e7b0e74 Thanks @HiDeoo! - Fixes a UI string translation issue for languages with a region subtag.
#2760 aec9edd Thanks @HiDeoo! - Adds 5 new icons: left-caret, up-arrow, down-arrow, download, and cloud-download.

0.30.4

Patch Changes

#2747 474c27e Thanks @bbag! - Ensures <Tab> component toggling is stable when smooth scrolling is enabled via custom CSS
#2740 0e169c9 Thanks @HiDeoo! - Fixes an issue preventing Pagefind to be disabled using the pagefind frontmatter field.
#2732 a10b466 Thanks @Sidnioulz! - Adds Storybook, Confluence and Jira social icons

0.30.3

Patch Changes

#2717 c5fcbb3 Thanks @delucis! - Fixes a list item spacing issue where line break elements (<br>) could receive a margin, breaking layout in Firefox
#2724 02d7ac6 Thanks @dionysuzx! - Adds social link support for Farcaster
#2635 ec4b851 Thanks @HiDeoo! - Fixes an issue where the language picker in multilingual sites could display the wrong language when navigating between pages with the browser back/forward buttons.
#2726 e54ebd5 Thanks @techfg! - Adds icon for phone

0.30.2

Patch Changes

#2702 02d16f3 Thanks @HiDeoo! - Fixes an issue with autogenerated sidebars when using Starlight with Astro's new Content Layer API with directories containing spaces or special characters.
#2704 fd16470 Thanks @delucis! - Fixes display of focus indicator around site title

0.30.1

Patch Changes

#2688 5c6996c Thanks @HiDeoo! - Fixes an issue with autogenerated sidebars when using Starlight with Astro's new Content Layer API where group names would be sluggified.

0.30.0

Minor Changes

#2612 8d5a4e8 Thanks @HiDeoo! - Adds support for Astro v5, drops support for Astro v4.

Upgrade Astro and dependencies

⚠️ BREAKING CHANGE: Astro v4 is no longer supported. Make sure you update Astro and any other official integrations at the same time as updating Starlight:
```
npx @astrojs/upgrade
```
Community Starlight plugins and Astro integrations may also need to be manually updated to work with Astro v5. 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.

Update your collections

⚠️ BREAKING CHANGE: Starlight's internal content collections, which organize, validate, and render your content, have been updated to use Astro's new Content Layer API and require configuration changes in your project.
1. Move the content config file. This file no longer lives within the src/content/config.ts folder and should now exist at src/content.config.ts.
2. Edit the collection definition(s). To update the docs collection, a loader is now required:
```
 // src/content.config.ts
 import { defineCollection } from "astro:content";
+import { docsLoader } from "@astrojs/starlight/loaders";
 import { docsSchema } from "@astrojs/starlight/schema";

 export const collections = {
-  docs: defineCollection({ schema: docsSchema() }),
+  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
 };
```
  If you are using the i18n collection to provide translations for additional languages you support or override our default labels, you will need to update the collection definition in a similar way and remove the collection type which is no longer available:
```
 // src/content.config.ts
 import { defineCollection } from "astro:content";
+import { docsLoader, i18nLoader } from "@astrojs/starlight/loaders";
 import { docsSchema, i18nSchema } from "@astrojs/starlight/schema";

 export const collections = {
-  docs: defineCollection({ schema: docsSchema() }),
+  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
-  i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
+  i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }),
 };
```
3. Update other collections. To update any other collections you may have, follow the “Updating existing collections” section in the Astro 5 upgrade guide.
If you are unable to make any changes to your collections at this time, including Starlight's default docs and i18n collections, you can enable the legacy.collections flag to upgrade to v5 without updating your collections. This legacy flag exists to provide temporary backwards compatibility, and will allow you to keep your collections in their current state until the legacy flag is no longer supported.

Patch Changes

#2669 310df7d Thanks @aaronperezaguilera! - Adds Catalan UI translations
#2664 62ff007 Thanks @HiDeoo! - Publishes provenance containing verifiable data to link a package back to its source repository and the specific build instructions used to publish it.
#2670 0223b42 Thanks @aaronperezaguilera! - Adds Spanish UI translations for the Pagefind search modal

0.29.3

Patch Changes

#2642 12750ae Thanks @dragomano! - Updates Russian UI translations
#2656 4d543be Thanks @HiDeoo! - Improves error message when an invalid configuration or no configuration is provided to the Starlight integration.
#2645 cf12beb Thanks @techfg! - Fixes support for favicon URLs that contain a search query and/or hash
#2650 38db4ec Thanks @raviqqe! - Moves @types/js-yaml package to non-dev dependencies
#2633 5adb720 Thanks @HiDeoo! - Fixes a VoiceOver issue with Safari where the content of a <script> element could be read before the sidebar content.
#2663 34755f9 Thanks @astrobot-houston! - Adds a new seti:vite icon for Vite configuration files in the <FileTree> component

0.29.2

Patch Changes

#2616 128cc51 Thanks @delucis! - Fixes an edge case to correctly avoid a trailing slash when navigating from a root locale homepage to another language via Starlight’s language switcher when trailingSlash: 'never' is set

0.29.1

Patch Changes

#2611 6059d96 Thanks @HiDeoo! - Fixes a UI string type issue in projects with multiple data content collections.
#2606 10b15a7 Thanks @delucis! - Makes <CardGrid> more resilient to complex child content on smaller viewports
#2605 ec7ab4f Thanks @brianzelip! - Exposes SidebarPersister component in package exports for use in custom overrides
#2614 9a31980 Thanks @HiDeoo! - Fixes an issue with custom pages using the <StarlightPage /> component and a custom sidebar missing highlighting for the active page and navigation links.
#2600 49aef17 Thanks @jdevega! - Adds Backstage social icon
#2613 a73780f Thanks @delucis! - Fixes support for sidebar frontmatter options in sidebar entries using slug or the string shorthand for internal links

0.29.0

Minor Changes

#2551 154c8e3 Thanks @hippotastic! - Updates the astro-expressive-code dependency to the latest version (0.38).

The new version allows using ec.config.mjs to selectively override individual Expressive Code styles and settings provided by Starlight themes and plugins, speeds up Shiki language loading, and adds the config option expressiveCode.shiki.injectLangsIntoNestedCodeBlocks. See the Expressive Code release notes for full details.
#2252 6116db0 Thanks @HiDeoo! - Improves build performance for sites with large sidebars

This release adds a caching layer to Starlight’s sidebar generation logic, reducing the number of times sidebars need to be regenerated while building a site. Some benchmarks for projects with a complex sidebar saw builds complete more than 35% faster with this change.
#2503 a4c8edd Thanks @HiDeoo! - Improves the accessibility of asides and tabs by removing some unnecessary HTML landmarks.

Patch Changes

#2579 241966b Thanks @RafidMuhymin! - Adds social link icon for Nostr

0.28.6

Patch Changes

#2565 236467b Thanks @HiDeoo! - Fixes an issue with custom UI strings defined in YAML files not being loaded in some contexts.

0.28.5

Patch Changes

#2546 bf42300 Thanks @HiDeoo! - Fixes an issue where i18n content collection related errors, e.g. malformed JSON or YAML, would not be reported.
#2548 07673c8 Thanks @HiDeoo! - Fixes a URL localization edge case. In projects without a root locale configured, slugs without a locale prefix did not fall back to the default locale as expected.
#2547 91e1dd7 Thanks @HiDeoo! - Fixes a Firefox Markdown content rendering issue for text sentences separated by a line break.
#2524 1b46783 Thanks @jsparkdev! - Fixes a broken link to Astro’s Docs in an error message

0.28.4

Patch Changes

#2444 d585b3e Thanks @HiDeoo! - Fixes a UI string translation issue for languages with a region subtag.
#2518 0f69db8 Thanks @morinokami! - Updates Japanese UI translations
#2507 bd6ced5 Thanks @HiDeoo! - Fixes a table of contents highlighting issue after resizing the window.
#2444 d585b3e Thanks @HiDeoo! - Refactors various components to use the new built-in localization system to access translated UI strings.

0.28.3

Patch Changes

#2408 0b4823d Thanks @HiDeoo! - Fixes a link formatting issue when using the Astro build.format option set to file with a base.
#2380 7b451cf Thanks @delucis! - Loosen Starlight’s i18n schema to pass through unknown keys
#2388 6bba3d8 Thanks @HiDeoo! - Fixes a potential type-checking issue in Starlight projects.
#2443 a0f40b3 Thanks @kevinzunigacuellar! - Fixes CSS issue where bottom padding is not applied in the search dialog.

0.28.2

Patch Changes

#2377 a257b83 Thanks @HiDeoo! - Fixes an issue with synced <Tabs> components containing nested <Tabs> causing tab panels to not render correctly.

0.28.1

Patch Changes

#2334 79b9ade Thanks @HiDeoo! - Fixes an issue with Expressive Code UI labels not displaying correctly.

0.28.0

Minor Changes

#1923 5269aad Thanks @HiDeoo! - Overhauls the built-in localization system which is now powered by the i18next library and available to use anywhere in your documentation website.

See the “Using UI translations” guide to learn more about how to access built-in UI labels or your own custom strings in your project. Plugin authors can also use the new injectTranslations() helper to add or update translation strings.

⚠️ BREAKING CHANGE: The Astro.props.labels props has been removed from the props passed down to custom component overrides.

If you are relying on Astro.props.labels (for example to read a built-in UI label), you will need to update your code to use the new Astro.locals.t() helper instead.
```
---
import type { Props } from '@astrojs/starlight/props';
// The `search.label` UI label for this page’s language:
const searchLabel = Astro.locals.t('search.label');
---
```
#2285 7286220 Thanks @HiDeoo! - Adds support for translating sidebar badges.
#1923 5269aad Thanks @HiDeoo! - ⚠️ BREAKING CHANGE: The minimum supported version of Astro is now 4.14.0

Please update Astro and Starlight together:
```
npx @astrojs/upgrade
```

Patch Changes

#2327 d7a295e Thanks @tritao! - Fixes restoration of remark directives for nodes with custom data attached.

0.27.1

Patch Changes

#2303 f92791a Thanks @delucis! - Fixes resolution for the internal module Git virtual module in projects with special characters in the file path

0.27.0

Minor Changes

#1255 6f3202b Thanks @Fryuni! - Adds support for server-rendered Starlight pages.

When building a project with hybrid or server output mode, a new prerender option on Starlight config can be set to false to make all Starlight pages be rendered on-demand:
```
export default defineConfig({
  output: 'server',
  integrations: [
    starlight({
      prerender: false,
    }),
  ],
});
```

Patch Changes

#2242 756e85e Thanks @delucis! - Refactors the logic for persisting and restoring sidebar state across navigations for better performance on slow or busy devices
#1255 6f3202b Thanks @Fryuni! - Improves performance of computing the last updated times from Git history.

Instead of executing git for each docs page, it is now executed twice regardless of the number of pages.
#1255 6f3202b Thanks @Fryuni! - Fixes last updated times on projects with custom srcDir

0.26.4

Patch Changes

#2288 b15f725 Thanks @matthewp! - Safely handle Zod errors

Prevents bugs where errors without the .received props would through and cause builds to fail unnecessarily.

0.26.3

Patch Changes

#2281 5062d30 Thanks @HiDeoo! - Fixes a potential text rendering issue that could include extra whitespaces for text containing colons.
#2279 62d59e2 Thanks @HiDeoo! - Fixes an issue with frontmatter schemas containing collection references used with the <StarlightPage /> component and an Astro version greater than 4.14.0.

0.26.2

Patch Changes

#2273 746e0cd Thanks @delucis! - Fixes type error when using Starlight with Astro v4.15
#2265 25b661e Thanks @SeraphicRav! - Adds TikTok social icon
#2272 d1969dd Thanks @o-az! - Adds new icon: jsr
#2250 c0a6166 Thanks @HiDeoo! - Removes internal E2E tests from the package published to the npm registry.
#2253 72bc76a Thanks @HiDeoo! - Fixes an issue preventing to use the class attribute in hero action link buttons.

0.26.1

Patch Changes

#2219 74d4716 Thanks @HiDeoo! - Fixes a sidebar persistence issue when navigating between pages with different sidebar content.

0.26.0

Minor Changes

#1784 68f56a7 Thanks @HiDeoo! - Adds <LinkButton> component for visually distinct and emphasized call to action links
#2150 9368494 Thanks @delucis! - Adds state persistence across page navigations to the main site sidebar
#2087 caa84ea Thanks @HiDeoo! - Adds persistence to synced <Tabs> so that a user's choices are reflected across page navigations.
#2051 ec3b579 Thanks @HiDeoo! - Adds a guideline to the last step of the <Steps> component.

If you want to preserve the previous behaviour and hide the guideline on final steps, you can add the following custom CSS to your site:
```
/* Hide the guideline for the final step in <Steps> lists. */
.sl-steps > li:last-of-type::after {
  background: transparent;
}
```
#1784 68f56a7 Thanks @HiDeoo! - Changes the hero component action button default variant from minimal to primary.

⚠️ BREAKING CHANGE: If you want to preserve the previous appearance, hero component action buttons previously declared without a variant will need to be updated to include the variant property with the value minimal.
```
hero:
  actions:
    - text: View on GitHub
      link: https://github.com/astronaut/my-project
      icon: external
+     variant: minimal
```
#2168 e044fee Thanks @HiDeoo! - ⚠️ BREAKING CHANGE: Updates the <StarlightPage /> component sidebar prop to accept an array of SidebarItems like the main Starlight sidebar configuration in astro.config.mjs.

This change simplifies the definition of sidebar items in the <StarlightPage /> component, allows for shared sidebar configuration between the global sidebar option and <StarlightPage /> component, and also enables the usage of autogenerated sidebar groups with the <StarlightPage /> component. If you are using the <StarlightPage /> component with a custom sidebar configuration, you will need to update the sidebar prop to an array of SidebarItem objects.

For example, the following custom page with a custom sidebar configuration defines a “Resources” group with a “New” badge, a link to the “Showcase” page which is part of the docs content collection, and a link to the Starlight website:
```
---
// src/pages/custom-page/example.astro
---

<StarlightPage
  frontmatter={{ title: 'My custom page' }}
  sidebar={[
    {
      type: 'group',
      label: 'Resources',
      badge: { text: 'New' },
      items: [
        { type: 'link', label: 'Showcase', href: '/showcase/' },
        {
          type: 'link',
          label: 'Starlight',
          href: 'https://starlight.astro.build/',
        },
      ],
    },
  ]}
>
  <p>This is a custom page with a custom component.</p>
</StarlightPage>
```
This configuration will now need to be updated to the following:
```
---
// src/pages/custom-page/example.astro
---

<StarlightPage
  frontmatter={{ title: 'My custom page' }}
  sidebar={[
    {
      label: 'Resources',
      badge: { text: 'New' },
      items: [
        'showcase',
        { label: 'Starlight', link: 'https://starlight.astro.build/' },
      ],
    },
  ]}
>
  <p>This is a custom page with a custom component.</p>
</StarlightPage>
```
See the “Sidebar Navigation” guide to learn more about the available options for customizing the sidebar.

0.25.5

Patch Changes

#2171 c8258d7 Thanks @delucis! - Improves build performance slightly for bigger sites
#2199 91557fd Thanks @connorjs! - Adds Azure DevOps (azureDevOps) icon for use in social links.

0.25.4

Patch Changes

#2155 8bed886 Thanks @delucis! - Improves page load performance on slower devices
#2167 9ac7725 Thanks @delucis! - Fixes an issue detecting the built-in locale when running Starlight in a web container environment on Firefox
#2166 4f12049 Thanks @delucis! - Updates @astrojs/mdx, @astrojs/sitemap, astro-expressive-code, unified, and vfile dependencies to the latest version

0.25.3

Patch Changes

#2154 0b381d5 Thanks @mktbsh! - Updates <head> logic to deduplicate <link rel="canonical"> tags. This means that custom canonicals set via frontmatter now override the default canonical generated by Starlight.
#2157 6757d97 Thanks @astrobot-houston! - Updates file tree icon mapping to correctly map .cjs and .mjs extensions in several contexts
#2156 904ad47 Thanks @delucis! - Fixes builds for projects with a space in their pathname
#2137 703903b Thanks @cevdetardaharan! - Removes twitter:title and twitter:description meta tags from <head>

0.25.2

Patch Changes

#2126 ada51ee Thanks @essential-randomness! - Adds support for markdown formatting in aside titles
#2135 9bbb969 Thanks @oluwatobiss! - Adds Pinterest social icon

0.25.1

Patch Changes

#2122 359a642 Thanks @HiDeoo! - Fixes an i18n configuration issue for multilingual sites when using Astro’s i18n config with prefixDefaultLocale set to false.
#2107 61e223b Thanks @sanabel-al-firdaws! - Updates Arabic UI translations
#2105 81f8a2c Thanks @delucis! - Fixes an edge case in custom pagination link processing

Custom link values for prev/next in page frontmatter are now always used as authored. Previously this was not the case in some edge cases such as for the first and final pages in the sidebar.
#2119 464685a Thanks @evadecker! - Improves styling of <hr>, <blockquote>, and <code> within asides

0.25.0

Minor Changes

#2025 47f32c1 Thanks @HiDeoo! - Removes the / search shortcut for accessibility reasons.

⚠️ Potentially breaking change: The search.shortcutLabel UI string has been removed. If you were using this string in your custom UI, you will need to update your code.
#2064 c5b47cb Thanks @SnowDingo! - Improves styling of Markdown tables to work better in different contexts, including against different background colours like when used in asides.
#2031 2bab648 Thanks @delucis! - Makes sidebar entry parsing stricter in Starlight config

⚠️ Potentially breaking change: Previously Starlight would accept a sidebar entry that matched one of its expected shapes, even if it included additional properties. For example, including both link and items was considered valid, with items being ignored. Now, it is an error to include more than one of link, items, or autogenerate in a sidebar entry.

If you see errors after updating, look for sidebar entries in the Starlight configuration in astro.config.mjs that include too many keys and remove the one that was previously ignored.
#1874 eeba06e Thanks @lorenzolewis! - Adds a new syntax for specifying sidebar link items for internal links

You can now specify an internal page using only its slug, either as a string, or as an object with a slug property:
```
starlight({
  title: 'Docs with easier sidebars',
  sidebar: ['getting-started', { slug: 'guides/installation' }],
});
```
Starlight will use the linked page’s frontmatter to configure the sidebar link.

Patch Changes

#2081 f0181d2 Thanks @andrii-bodnar! - Updates the Ukrainian UI translations

0.24.5

Patch Changes

#2062 5ac0ac6 Thanks @evadecker! - Increase theme and language select inline padding
#2056 87e9ad0 Thanks @HiDeoo! - Fixes an issue preventing remark plugins injected by Starlight plugins to handle Markdown text and leaf directives.
#2063 3ee1a94 Thanks @delucis! - Translate fileTree.directory and aside.* UI string into Norwegian (Bokmål).
#2054 dbfd3ee Thanks @HiDeoo! - Fixes an issue when using the <StarlightPage> component in a custom page with a user-defined srcDir configuration.

0.24.4

Patch Changes

#2038 87f3f92 Thanks @dragomano! - Updates Russian UI translations
#2043 53f4cd4 Thanks @playmr365! - Updates Czech UI translations
#2041 8af5a60 Thanks @HiDeoo! - Fixes <Steps> numbering bug caused by Chrome v126 CSS counter rewrite

0.24.3

Patch Changes

#2028 af81ad3 Thanks @HiDeoo! - Fixes a search dialog height issue in Safari.
#2022 80f82b1 Thanks @playmr365! - Updates Czech UI translations

0.24.2

Patch Changes

#2008 40359c7 Thanks @vnepogodin! - Add Slovak language UI translation.
#2004 0aa2f06 Thanks @liruifengv! - Removes an outdated export in package.json
#2007 44ca490 Thanks @delucis! - Updates internal dependencies
#1993 60165b2 Thanks @HiDeoo! - Fixes an i18n configuration issue when using a single root locale.

0.24.1

Patch Changes

#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.

0.24.0

Minor Changes

#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

0.23.4

Patch Changes

#1955 15ef1f4b Thanks @HiDeoo! - Reverts a change to prevent a numbering issue with the <Steps> component in future versions of Chrome.

0.23.3

Patch Changes

#1948 68c0c077 Thanks @HiDeoo! - Fixes a <Steps> component numbering issue with the next Chrome stable version when a step contains a nested list.
#1909 c98c7088 Thanks @joshka! - Adds Discourse to social icons

0.23.2

Patch Changes

#1913 7ebe8f75 Thanks @delucis! - Fixes support for Astro’s build: { format: 'preserve' } configuration option
#1941 2f3240c9 Thanks @astrobot-houston! - Adds icon support for .otf files in <FileTree>

0.23.1

Patch Changes

#1892 01de9be8 Thanks @delucis! - Internal refactor: simplify some CSS for the <details> element

0.23.0

Minor Changes

#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/config
export 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
```

0.22.4

Patch Changes

#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

0.22.3

Patch Changes

#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

0.22.2

Patch Changes

#1811 fe06aa13 Thanks @HiDeoo! - Fixes a <Tabs> sync issue when inconsistently using the icon prop or not on <TabItem> components.
#1826 52ea7381 Thanks @dragomano! - Updates Russian UI translations

0.22.1

Patch Changes

1c0fc384 Thanks @HiDeoo! - Fixes an issue where the siteTitle property would not be set when using the <StarlightPage /> component.

0.22.0

Minor Changes

#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

Patch Changes

#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

0.21.5

Patch Changes

#1728 0a75680d Thanks @delucis! - Adds 1 new icon: pkl
#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

0.21.4

Patch Changes

#1703 b26238f2 Thanks @HiDeoo! - Fixes aside custom titles rendering for nested asides.
#1708 a72cb966 Thanks @HiDeoo! - Fixes translation issues with Expressive Code when using a default language other than English

0.21.3

Patch Changes

#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.

0.21.2

Patch Changes

#1628 24c0823c Thanks @o-az! - Adds 1 new icon: nix
#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.

0.21.1

Patch Changes

#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.

0.21.0

Minor Changes

#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.

0.20.1

Patch Changes

#1553 8e091147 Thanks @hippotastic! - Updates Expressive Code to v0.33.4 to fix potential race condition bug in Shiki.

0.20.0

Minor Changes

#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.

Patch Changes

#1542 b3b7a606 Thanks @delucis! - Improves error messages shown by Starlight for configuration errors.
#1544 65dc6586 Thanks @torn4dom4n! - Update Vietnamese UI translations

0.19.1

Patch Changes

#1527 163bc84 Thanks @HiDeoo! - Exports the StarlightPageProps TypeScript type representing the props expected by the <StarlightPage /> component.
#1504 fc83a05 Thanks @mingjunlu! - Adds Traditional Chinese UI translations
#1534 aada680 Thanks @delucis! - Improves DX of the sidebar prop used by the new <StarlightPage> component.

0.19.0

Minor Changes

#1485 2cb3578 Thanks @timokoessler! - Add support for setting html attributes of hero action links
#1175 dd11b95 Thanks @HiDeoo! - Adds a new <StarlightPage> component to use the Starlight layout in custom pages.

To learn more about this new feature, check out the new “Using Starlight’s design in custom pages” guide.
#1499 97bf523 Thanks @delucis! - Adds a new <Aside> component

The new component is in addition to the existing custom Markdown syntax.

0.18.1

Patch Changes

#1487 6a72bda Thanks @NavyStack! - Improves Korean UI translations
#1489 b0d36de Thanks @HiDeoo! - Fixes a potential text rendering issue with text containing colons.

0.18.0

Minor Changes

#1454 1d9ef56 Thanks @Fryuni! - Makes Starlight compatible with on-demand server rendering (sometimes referred to as server-side rendering or SSR).

Starlight pages are always prerendered, even when using output: 'server'.
#1454 1d9ef56 Thanks @Fryuni! - Enables Astro’s experimental.globalRoutePriority option and bumps the minimum required Astro version.

⚠️ BREAKING CHANGE The minimum supported Astro version is now 4.2.7. Upgrade Astro and Starlight together:
```
npx @astrojs/upgrade
```

0.17.4

Patch Changes

#1473 29da505 Thanks @delucis! - Fixes a CSS bug for users with JavaScript disabled
#1465 ce3108c Thanks @delucis! - Updates internal MDX, sitemap, and Expressive Code dependencies to the latest versions

0.17.3

Patch Changes

#1461 2e17880 Thanks @liruifengv! - Improves the table of contents title translation in Simplified Chinese
#1462 4741ccc Thanks @delucis! - Fixes overflow of very long site titles on narrow viewports
#1459 9a8e0ec Thanks @delucis! - Fixes a bug where table of contents highlighting could break given very specific combinations of content and viewport size
#1458 8c88642 Thanks @delucis! - Silences i18n content collection warnings for projects without custom translations.

0.17.2

Patch Changes

#1442 1a642e4 Thanks @delucis! - Fixes URLs in language picker for sites with build.format: 'file'
#1440 2ea1e88 Thanks @hippotastic! - Adds JS support to the @astrojs/starlight/expressive-code export to allow importing from non-TS environments.

0.17.1

Patch Changes

#1437 655aed4 Thanks @hippotastic! - Adds Starlight-specific types to defineEcConfig function and exports StarlightExpressiveCodeOptions.

This provides Starlight types and IntelliSense support for your Expressive Code configuration options inside an ec.config.mjs file. See the Expressive Code documentation for more information.
#1420 275f87f Thanks @abdelhalimjean! - Fix rare font-family issue if users have a font installed with a name of ""
#1365 a0af7cc Thanks @kevinzunigacuellar! - Correctly format Pagefind search result links when trailingSlash: 'never' is used

0.17.0

Minor Changes

#1389 21b3620 Thanks @connor-baer! - Adds new disable404Route config option to disable injection of Astro’s default 404 route
#1395 ce05dfb Thanks @hippotastic! - Adds a new <Code> component to render dynamic code strings with Expressive Code

0.16.0

Minor Changes

#1383 490c6ef Thanks @delucis! - Refactors Starlight’s internal virtual module system for components to avoid circular references

This is a change to an internal API. If you were importing the internal virtual:starlight/components module, this no longer exists. Update your imports to use the individual virtual modules now available for each component, for example virtual:starlight/components/EditLink.
#1151 134292d Thanks @kevinzunigacuellar! - Fixes sidebar auto-generation issue when a file and a directory, located at the same level, have identical names.

For example, src/content/docs/guides.md and src/content/docs/guides/example.md will now both be included and src/content/docs/guides.md is treated in the same way a src/content/docs/guides/index.md file would be.
#1386 0163634 Thanks @delucis! - Tightens line-height on <LinkCard> titles to fix regression from original design

If you want to preserve the previous line-height, you can add the following custom CSS to your site:
```
.sl-link-card a {
	line-height: 1.6;
}
```
#1376 8398432 Thanks @delucis! - Tweaks vertical spacing in Markdown content styles.

This is a subtle change to Starlight’s default content styling that should improve most sites:
- Default vertical spacing between content items is reduced from 1.5rem to 1rem.
- Spacing before headings is now relative to font size, meaning higher-level headings have slightly more spacing and lower-level headings slightly less.
The overall impact is to tighten up content that belongs together and improve the visual hierarchy of headings to break up sections.

Although this is a subtle change, we recommend visually inspecting your site in case this impacts layout of any custom CSS or components.

If you want to preserve the previous spacing, you can add the following custom CSS to your site:
```
/* Restore vertical spacing to match Starlight v0.15 and below. */
.sl-markdown-content
	:not(a, strong, em, del, span, input, code)
	+ :not(a, strong, em, del, span, input, code, :where(.not-content *)) {
	margin-top: 1.5rem;
}
.sl-markdown-content
	:not(h1, h2, h3, h4, h5, h6)
	+ :is(h1, h2, h3, h4, h5, h6):not(:where(.not-content *)) {
	margin-top: 2.5rem;
}
```

#1372 773880d Thanks @HiDeoo! - Updates the table of contents highlighting styles to prevent UI shifts when scrolling through a page.

If you want to preserve the previous, buggy styling, you can add the following custom CSS to your site:

starlight-toc a[aria-current='true'],
starlight-toc a[aria-current='true']:hover,
starlight-toc a[aria-current='true']:focus {
	font-weight: 600;
	color: var(--sl-color-text-invert);
	background-color: var(--sl-color-text-accent);
}

0.15.4

Patch Changes

#1378 0f4a31d Thanks @delucis! - Updates dependencies: @astrojs/mdx, @astrojs/sitemap, and astro-expressive-code

0.15.3

Patch Changes

#1303 3eefd21 Thanks @lilnasy! - chore: fix type errors in Starlight internals
#1351 932c022 Thanks @roberto-butti! - Adds Italian translation for search.devWarning UI
#1298 c7e995c Thanks @kevinzunigacuellar! - Fixes incorrect sorting behavior for some autogenerated sidebars
#1347 8994d00 Thanks @kevinzunigacuellar! - Refactor getLastUpdated to use node:child_process instead of execa.
#1353 90fe8da Thanks @delucis! - Fixes sidebar scrollbar hiding behind navbar

0.15.2

Patch Changes

#1254 e9659e8 Thanks @Pukimaa! - Adds Open Collective social link icon
#1295 c3732a9 Thanks @juchym! - Improve Ukrainian UI translations

0.15.1

Patch Changes

#1273 ae53155 Thanks @natemoo-re! - Updates <SocialIcon /> styling for improved accessibility. Specifically, the component now meets the Target Size (Minimum) success criteria defined by Web Content Accessibility Guidelines (WCAG) 2.2.
#1289 9bd343f Thanks @HiDeoo! - Adds French translations for Expressive Code UI
#1280 6b1693d Thanks @kevinzunigacuellar! - Adds Spanish translations for Expressive Code UI
#1276 667f23d Thanks @hippotastic! - Updates astro-expressive-code dependency to the latest version
#1266 c9edf30 Thanks @alex-way! - Removes redundant subprocess calls in git last-updated time utility to improve performance
#1278 e88abb0 Thanks @HiDeoo! - Exports the StarlightUserConfig TypeScript type representing the user's Starlight configuration received by plugins.

0.15.0

Minor Changes

#1238 02a808e Thanks @delucis! - Add support for Astro v4, drop support for Astro v3

⚠️ BREAKING CHANGE Astro v3 is no longer supported. Make sure you update Astro and any other integrations at the same time as updating Starlight.

Use the new @astrojs/upgrade command to upgrade Astro and Starlight together:
```
npx @astrojs/upgrade
```
#1242 d8fc9e1 Thanks @delucis! - Enables link prefetching on hover by default

Astro v4’s prefetch support is now enabled by default. If prefetch is not set in astro.config.mjs, Starlight will use prefetch: { prefetchAll: true, defaultStrategy: 'hover' } by default.

If you want to preserve previous behaviour, disable link prefetching in astro.config.mjs:
```
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';

export default defineConfig({
	// Disable link prefetching:
	prefetch: false,

	integrations: [
		starlight({
			// ...
		}),
	],
});
```

Patch Changes

#1226 909afa2 Thanks @tlandmangh! - Add Dutch translations of default aside labels
#1243 ee234eb Thanks @khajimatov! - Fix typo in Russian untranslated content notice
#1170 bcc2301 Thanks @tmcw! - Fix timezone-reliance in LastUpdated
#1203 4601449 Thanks @orhun! - Adds Matrix social link icon

0.14.0

Minor Changes

#1144 7c0b8cb Thanks @delucis! - Adds a configuration option to disable site indexing with Pagefind and the default search UI
#942 efd7fdc Thanks @HiDeoo! - Adds plugin API

See the plugins reference to learn more about creating plugins for Starlight using this new API.
#1135 e5a863a Thanks @delucis! - Exposes localized UI strings in route data

Component overrides can now access a labels object in their props which includes all the localized UI strings for the current page.
#1162 00d101b Thanks @delucis! - Adds support for extending Starlight’s content collection schemas

0.13.1

Patch Changes

#1111 cb19d07 Thanks @at-the-vr! - Fix minor punctuation typo in Hindi UI string
#1156 631c5ae Thanks @votemike! - Updates @astrojs/sitemap dependency to the latest version
#1109 0c25c1f Thanks @HiDeoo! - Internal: fix import issue with expressive-code

0.13.0

Minor Changes

#1023 a3b80f7 Thanks @kevinzunigacuellar! - Respect the trailingSlash and build.format Astro options when creating Starlight navigation links.

⚠️ Potentially breaking change: This change will cause small changes in link formatting for most sites. These are unlikely to break anything, but if you care about link formatting, you may want to change some Astro settings.

If you want to preserve Starlight’s previous behavior, set trailingSlash: 'always' in your astro.config.mjs:
```
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';

export default defineConfig({
	trailingSlash: 'always',
	integrations: [
		starlight({
			// ...
		}),
	],
});
```
#742 c6a4bcb Thanks @hippotastic! - Adds Expressive Code as Starlight’s default code block renderer

⚠️ Potentially breaking change: This addition changes how Markdown code blocks are rendered. By default, Starlight will now use Expressive Code. If you were already customizing how code blocks are rendered and don't want to use the features provided by Expressive Code, you can preserve the previous behavior by setting the new config option expressiveCode to false.

If you had previously added Expressive Code manually to your Starlight project, you can now remove the manual set-up in astro.config.mjs:
- Move your configuration to Starlight’s new expressiveCode option.
- Remove the astro-expressive-code integration.
For example:
```
import starlight from '@astrojs/starlight';
import { defineConfig } from 'astro/config';
- import expressiveCode from 'astro-expressive-code';

export default defineConfig({
  integrations: [
-   expressiveCode({
-     themes: ['rose-pine'],
-   }),
    starlight({
      title: 'My docs',
+     expressiveCode: {
+       themes: ['rose-pine'],
+     },
    }),
  ],
});
```
Note that the built-in Starlight version of Expressive Code sets some opinionated defaults that are different from the astro-expressive-code defaults. You may need to set some styleOverrides if you wish to keep styles exactly the same.
#517 5b549cb Thanks @liruifengv! - Add i18n support for default aside labels

Patch Changes

#1088 4fe5537 Thanks @Lootjs! - i18n(ru): added Russian aside labels translation
#1083 e03a653 Thanks @at-the-vr! - i18n(hi): Add Hindi language support
#1075 2f2adf2 Thanks @russbiggs! - Add Slack social link icon
#1065 2d72ed6 Thanks @HiDeoo! - Ignore search keyboard shortcuts for elements with contents that are editable
#1081 f27f781 Thanks @farisphp! - i18n(id): Add Indonesian aside labels translation
#1082 ce27486 Thanks @bogdaaamn! - i18n(ro): Add Romanian UI translations

0.12.1

Patch Changes

#1069 b86f360 Thanks @Genteure! - Fix sidebar highlighting and navigation buttons for pages with path containing non-ASCII characters
#1025 0d1e75e Thanks @HiDeoo! - Internal: fix import issue in translation string loading mechanism
#1044 a5a9754 Thanks @HiDeoo! - Fix last updated dates for pages displaying fallback content
#1049 c27495d Thanks @HiDeoo! - Expose Markdown content styles in @astrojs/starlight/style/markdown.css

0.12.0

Minor Changes

#995 5bf4457 Thanks @kevinzunigacuellar! - Adds support for adding sidebar badges to group headings
#988 977fe13 Thanks @magicDGS! - Include social icon links in mobile menu
#280 72cca2d Thanks @cbontems! - Support light & dark variants of the hero image.

⚠️ Potentially breaking change: The hero.image schema is now slightly stricter than previously.

The hero.image.html property can no longer be used alongside the hero.image.alt or hero.image.file properties. Previously, html was ignored when used with file and alt was ignored when used with html. Now, those combinations will throw errors. If you encounter errors, remove the image.hero property that is not in use.

Patch Changes

#1004 7f92213 Thanks @nunhes! - Add Galician language support
#1003 f1fdb50 Thanks @delucis! - Internal: refactor translation string loading to make translations available to Starlight integration code

0.11.2

Patch Changes

#944 7a6446e Thanks @HiDeoo! - Fix issue with sidebar autogenerated groups configured with a directory containing leading or trailing slash
#985 92b3b57 Thanks @delucis! - Fix edit URLs for pages displaying fallback content
#986 0470734 Thanks @dreyfus92! - Prevent overscrolling on mobile table of contents by setting 'overscroll-behavior: contain'.
#924 39d6302 Thanks @kevinzunigacuellar! - Remove extra margin from markdown lists that uses inline code
#814 1e517d9 Thanks @julien-deramond! - Prevent text from overflowing pagination items

0.11.1

Patch Changes

#892 2b30321 Thanks @delucis! - Add Patreon social link icon
#854 71a52a1 Thanks @mehalter! - Add Reddit icon
#852 344c92e Thanks @Lootjs! - Improve Russian language support
#891 395920c Thanks @Frikadellios! - Add Ukrainian language support
#890 63ea8e8 Thanks @delucis! - Update execa dependency to v8
#859 eaa7a90 Thanks @oggnimodd! - Improve Indonesian language support
#864 b84aff2 Thanks @mehalter! - Optimize UI icon SVG paths

0.11.0

Minor Changes

#774 903a579 Thanks @HiDeoo! - Support adding HTML attributes to sidebar links from config and frontmatter
#796 372ec96 Thanks @HiDeoo! - Add the @astrojs/sitemap and @astrojs/mdx integrations only if they are not detected in the Astro configuration.

⚠️ BREAKING CHANGE The minimum supported version of Astro is now v3.2.0. Make sure you update Astro at the same time as updating Starlight:
```
npm install astro@latest
```
#447 b45719b Thanks @andremralves! - Add titleDelimiter configuration option and include site title in page <title> tags

⚠️ BREAKING CHANGE — Previously, every page’s <title> only included its individual frontmatter title. Now, <title> tags include the page title, a delimiter character (| by default), and the site title. For example, in the Startlight docs, <title>Configuration Reference</title> is now <title>Configuration Reference | Starlight</title>.

If you have a page where you need to override this new behaviour, set a custom title using the head frontmatter property:
```
---
title: My Page
head:
  - tag: title
    content: Custom Title
---
```
#709 140e729 Thanks @delucis! - Add support for overriding Starlight’s built-in components

⚠️ BREAKING CHANGE — The page footer is now included on pages with template: splash in their frontmatter. Previously, this was not the case. If you are using template: splash and want to continue to hide footer elements, disable them in your frontmatter:
```
---
title: Landing page
template: splash
# Disable unwanted footer elements as needed
editUrl: false
lastUpdated: false
prev: false
next: false
---
```
⚠️ BREAKING CHANGE — This change involved refactoring the structure of some of Starlight’s built-in components slightly. If you were previously overriding these using other techniques, you may need to adjust your code.

Patch Changes

#815 b7b23a2 Thanks @HiDeoo! - Add Facebook and email icons
#810 dbe977b Thanks @hasham-qaiser! - Use <span> instead of <h2> in sidebar group headings
#807 7c73dd1 Thanks @torn4dom4n! - Add Vietnamese translations for Starlight UI
#756 f55a8f0 Thanks @julien-deramond! - Prevent text from overflowing in several cases

0.10.4

Patch Changes

#752 6833ee1 Thanks @apinet! - Add X social link logo
#789 2528fb0 Thanks @delucis! - Update bundled version of @astrojs/mdx to v1.1.0
#794 a0de12d Thanks @HiDeoo! - Add Telegram icon
#792 a8358df Thanks @HiDeoo! - Add RSS icon
#778 957d2c3 Thanks @jermanuts! - Improve Arabic UI translations

0.10.3

Patch Changes

#783 f94727e Thanks @kevinzunigacuellar! - Fix GitHub edit link to include src path from project config
#781 a293ef9 Thanks @dreyfus92! - Removed role from Banner component to avoid duplication in header.
#745 006d606 Thanks @TheOtterlord! - Prevent Starlight crashing when the content folder doesn't exist, or is empty
#775 2ef3036 Thanks @delucis! - Fix content collection schema compatibility with Astro 3.1 and higher
#773 423d575 Thanks @tlandmangh! - Fix Dutch UI translation for “Previous page” links

0.10.2

Patch Changes

#735 2da8692 Thanks @delucis! - Use Starlight font custom property in Pagefind modal
#735 2da8692 Thanks @delucis! - Fix RTL styling in Pagefind modal
#739 a9de4a7 Thanks @radenpioneer! - Add Indonesian UI translation
#747 7589515 Thanks @nirtamir2! - Add Hebrew UI translations

0.10.1

Patch Changes

#726 f3157c6 Thanks @delucis! - Fix a rare bug in table of contents when handling headings that increase by more than one level on a page.
#729 80c6ab1 Thanks @delucis! - Upgrade Pagefind to v1.0.3
#715 e726155 Thanks @itsmatteomanf! - feat: prevent scroll on body when search is open

0.10.0

Minor Changes

#692 2a58e1a Thanks @delucis! - Upgrade Pagefind to v1 and display page headings in search results

Patch Changes

#708 136cfb1 Thanks @julien-deramond! - Fix main content column width for pages without a table of contents
#682 660a5f5 Thanks @vedmalex! - Add Russian language support

0.9.1

Patch Changes

#647 ea57726 Thanks @bgmort! - Fix translated 404 pages not being excluded from search results
#667 9828f73 Thanks @delucis! - Break inline <code> across lines to avoid overflow
#642 e623d92 Thanks @fk! - Don't hard-code nav height in table of contents highlighting script
#676 6419006 Thanks @vedmalex! - Upgrade and pin Pagefind to latest beta release.
#647 ea57726 Thanks @bgmort! - Add frontmatter option to exclude a page from Pagefind search results

0.9.0

Minor Changes

#626 5dd22b8 Thanks @delucis! - Throw an error for duplicate MDX or sitemap integrations
#615 7b75b3e Thanks @delucis! - Bump minimum required Astro version to 3.0

⚠️ BREAKING CHANGE Astro v2 is no longer supported. Make sure you update Astro and any other integrations at the same time as updating Starlight.

0.8.1

Patch Changes

#612 1b367e3 Thanks @KubaJastrz! - Avoid applying hovered <select> text color to its <options>

0.8.0

Minor Changes

#529 c2d0e7f Thanks @delucis! - For improved compatibility with Tailwind, some Starlight built-in class names are now prefixed with "sl-".

While not likely, if you were relying on one of these internal class names in your own components or custom CSS, you will need to update to use the prefixed version.
- Before: flex, md:flex, lg:flex, block, md:block, lg:block, hidden, md:hidden, lg:hidden.
- After: sl-flex, md:sl-flex, lg:sl-flex, sl-block, md:sl-block, lg:sl-block, sl-hidden, md:sl-hidden, lg:sl-hidden.
#593 5b8af95 Thanks @delucis! - Add announcement banner feature
#516 70a32a1 Thanks @kevinzunigacuellar! - Support adding badges to sidebar links from config file and frontmatter

Patch Changes

#569 a7691f8 Thanks @HiDeoo! - Use locale when sorting autogenerated sidebar entries
#559 5726353 Thanks @delucis! - Add Stack Overflow icon

0.7.3

Patch Changes

#525 87caf21 Thanks @delucis! - Improve inline code and code block support in RTL languages
#537 56c19bc Thanks @carlgleisner! - Add Swedish UI translations.
#528 f5e5503 Thanks @jsparkdev! - add Korean language support

0.7.2

Patch Changes

#506 5e3133c Thanks @HiDeoo! - Improve table of content current item highlight behavior
#499 fcff49e Thanks @D3vil0p3r! - Add icons for Instagram
#502 3c87a16 Thanks @Mrahmani71! - Add Farsi UI translations
#496 cd28392 Thanks @lorenzolewis! - Fix lastUpdated date position to be consistent
#402 d8669b8 Thanks @chopfitzroy! - Fix content sometimes appearing above the mobile table of contents.

0.7.1

Patch Changes

#488 da35556 Thanks @mayank99! - Improved accessibility of LinkCard by only including the title as part of the link text, and using a pseudo-element to keep the card clickable.
#489 35cd82e Thanks @HiDeoo! - Respect hidden sidebar frontmatter property when no sidebar configuration is provided

0.7.0

Minor Changes

#441 0119a49 Thanks @lorenzolewis! - Add support for hiding entries from an autogenerated sidebar:
```
---
title: About this project
sidebar:
  hidden: true
---
```
#470 d076aec Thanks @delucis! - Drop support for the --sl-hue-accent CSS custom property.

⚠️ BREAKING CHANGE — In previous Starlight versions you could control the accent color by setting the --sl-hue-accent custom property. This could result in inaccessible color contrast and unpredictable results.

You must now set accent colors directly. If you relied on setting --sl-hue-accent, migrate by setting light and dark mode colors in your custom CSS:
```
:root {
	--sl-hue-accent: 234;
	--sl-color-accent-low: hsl(var(--sl-hue-accent), 54%, 20%);
	--sl-color-accent: hsl(var(--sl-hue-accent), 100%, 60%);
	--sl-color-accent-high: hsl(var(--sl-hue-accent), 100%, 87%);
}

:root[data-theme='light'] {
	--sl-color-accent-high: hsl(var(--sl-hue-accent), 80%, 30%);
	--sl-color-accent: hsl(var(--sl-hue-accent), 90%, 60%);
	--sl-color-accent-low: hsl(var(--sl-hue-accent), 88%, 90%);
}
```
The new color theme editor might help if you’d prefer to set a new color scheme.
#397 73eb5e6 Thanks @lorenzolewis! - Add LinkCard component

Patch Changes

#460 2e0fb90 Thanks @HiDeoo! - Fix current page highlight in sidebar for URLs with no trailing slash
#467 461a5d5 Thanks @delucis! - Fix type error for downstream tsc users
#475 06a205e Thanks @Yan-Thomas! - Locales whose language tag includes a regional subtag now use built-in UI translations for their base language. For example, a locale with a language of pt-BR will use our pt UI translations.
#473 6a7692a Thanks @HiDeoo! - Fix issue with nested <Tabs> components

0.6.1

Patch Changes

#442 42c0abd Thanks @HiDeoo! - Increase Markdown table border contrast
#443 cb8bcec Thanks @delucis! - Add icons for Bitbucket, Gitter, CodePen, and Microsoft Teams
#445 a80e180 Thanks @HiDeoo! - Prevent repeated table of contents mark on mobile

0.6.0

Minor Changes

#424 4485d90 Thanks @delucis! - Add support for customising autogenerated sidebar link labels from page frontmatter, overriding the page title:
```
---
title: About this project
sidebar:
  label: About
---
```
#359 e733311 Thanks @IDurward! - Add support for defining the order of auto-generated link groups in the sidebar using a frontmatter value:
```
---
title: Page to display first
sidebar:
  order: 1
---
```

Patch Changes

#413 5a9d8f1 Thanks @delucis! - Fix site title overflow bug for longer titles on narrow screens
#381 6e62909 Thanks @lorenzolewis! - Preserve order of social config in navbar
#419 38ff53c Thanks @lorenzolewis! - Improve styling of sidebar entries that wrap onto multiple lines
#418 c7b2a4e Thanks @delucis! - Set tab-size: 2 on content code blocks to override default browser value of 8
#399 31b8a5a Thanks @HiDeoo! - Add new global favicon option defaulting to '/favicon.svg' to set the path of the default favicon for your website. Additional icons can be specified using the head option.
#414 e951671 Thanks @delucis! - Add GitLab to social link icons

0.5.6

Patch Changes

#383 0ebc47e Thanks @delucis! - Fix edge case where index files in an index directory would end up with the wrong slug
#373 308b3aa Thanks @lorenzolewis! - Fix visual overflow for wide logos
#385 fb35397 Thanks @lorenzolewis! - Fix nested elements in markdown content
#386 e6f6f30 Thanks @huijing! - Prevent search keyboard shortcuts from triggering when input elements are focused

0.5.5

Patch Changes

a161c05 Thanks @delucis! - Fix missing metadata required for astro add support

0.5.4

Patch Changes

#360 8415df6 Thanks @HiDeoo! - Fix build warnings when using the TypeScript verbatimModuleSyntax compiler option

0.5.3

Patch Changes

#352 a2e23be Thanks @TheOtterlord! - Fix page scrolling when the window resizes, while the mobile nav is open
#353 65b2b75 Thanks @liruifengv! - Add Simplified Chinese language support

0.5.2

Patch Changes

#343 d618678 Thanks @delucis! - Fix escaping of non-relative user config file paths for custom CSS and logos

0.5.1

Patch Changes

#336 2b3302b Thanks @delucis! - Add support for LinkedIn, Threads, and Twitch social icon links
#335 757c65f Thanks @delucis! - Fix relative path resolution on Windows
#332 0600c1a Thanks @sasoria! - Add Norwegian UI translations
#328 e478848 Thanks @astridx! - Add missing accessible labels for Codeberg and YouTube social links

0.5.0

Minor Changes

#313 dc42569 Thanks @delucis! - Add a not-content CSS class that allows users to opt out of Starlight’s default content styling
#297 fb15a9b Thanks @HiDeoo! - Improve <Tabs> component keyboard interactions
#303 69b7d4c Thanks @HiDeoo! - Add new global pagination option defaulting to true to define whether or not the previous and next page links are shown in the footer. A page can override this setting or the link text and/or URL using the new prev and next frontmatter fields.

Patch Changes

#318 5db3e6e Thanks @delucis! - Support relative paths in Starlight config for customCSS and logo paths

0.4.2

Patch Changes

#308 c3aa4c6 Thanks @delucis! - Fix use of default monospace font stack
#286 a2aedfc Thanks @mzaien! - Add Arabic UI translations

0.4.1

Patch Changes

#300 377a25d Thanks @cbontems! - Fix broken link on 404 page when defaultLocale: 'root' is set in astro.config.mjs
#289 dffca46 Thanks @RyanRBrown! - Fix saturation of purple text in light theme
#301 d47639d Thanks @delucis! - Enable inline stylesheets for Astro versions ≥2.6.0

0.4.0

Minor Changes

#259 8102389 Thanks @HiDeoo! - Add support for collapsed sidebar groups
#254 faa70de Thanks @HiDeoo! - Expose <Icon> component
#256 048e948 Thanks @HiDeoo! - Add new global lastUpdated option defaulting to false to define whether or not the last updated date is shown in the footer. A page can override this setting or the generated date using the new lastUpdated frontmatter field.

⚠️ Breaking change. Starlight will no longer show this date by default. To keep the previous behavior, you must explicitly set lastUpdated to true in your configuration.
```
starlight({
+ lastUpdated: true,
}),
```

Patch Changes

#264 ed1e46b Thanks @astridx! - Add new icon for displaying codeberg.org in social links.
#260 01b65b1 Thanks @ElianCodes! - Add Dutch UI translations
#269 fdc18b5 Thanks @baspinarenes! - Add Turkish UI translations
#270 1d3e705 Thanks @cbontems! - Improve French UI translations
#272 6b23ebc Thanks @cbontems! - Add YouTube social link support
#267 af2e43c Thanks @nikcio! - Add Danish UI translations
#273 d4f5134 Thanks @Waxer59! - Fix typo in Spanish UI translations

0.3.1

Patch Changes

#257 0502327 Thanks @JosefJezek! - Add Czech language support
#261 2062b9e Thanks @delucis! - Fix autogenerated navigation for pages using fallback content

0.3.0

Minor Changes

#237 4279d75 Thanks @HiDeoo! - Use path instead of slugified path for auto-generated sidebar item configuration

⚠️ Potentially breaking change. If your docs directory names don’t match their URLs, for example they contain whitespace like docs/my docs/, and you were referencing these in an autogenerate sidebar group as my-docs, update your config to reference these with the directory name instead of the slugified version:
```
autogenerate: {
- directory: 'my-docs',
+ directory: 'my docs',
}
```
#226 1aa2187 Thanks @delucis! - Add support for custom 404 pages.

Patch Changes

#234 91309ae Thanks @morinokami! - Add Japanese translation for search.devWarning
#227 fbdecfa Thanks @Yan-Thomas! - Add missing i18n support to the Search component's dev warning.
#244 f1bcbeb Thanks @Waxer59! - Add Spanish translation for search.devWarning

0.2.0

Minor Changes

#171 198c3f0 Thanks @delucis! - Add Starlight generator tag to HTML output
#217 490fd98 Thanks @delucis! - Updated sidebar styles. Sidebars now support top-level links and groups are styled with a subtle border and indentation to improve comprehension of nesting.
#178 d046c55 Thanks @delucis! - Add support for translating the Pagefind search modal
#210 cb5b121 Thanks @delucis! - Change page title ID to _top for cleaner hash URLs

⚠️ Potentially breaking change if you were linking manually to #starlight__overview anywhere. If you were, update these links to use #_top instead.

Patch Changes

#208 09fc565 Thanks @delucis! - Update @astrojs/mdx and @astrojs/sitemap to latest
#216 54905c5 Thanks @morinokami! - Encode heading id when finding current link

0.1.4

Patch Changes

#190 a3809e4 Thanks @gabrielemercolino! - Added Italian language support
#193 c9ca4eb Thanks @BryceRussell! - Fix bottom padding for sidebar on larger screen sizes

0.1.3

Patch Changes

#183 89e0a04 Thanks @delucis! - Fix disclosure caret rotation in sidebar sub-groups
#177 bdafdb0 Thanks @rviscomi! - Fix Markdown table overflow
#185 4844915 Thanks @delucis! - Support setting an SVG as the hero image file

0.1.2

Patch Changes

#174 6ab31b4 Thanks @rviscomi! - Split withBase URL helper to fix use with files.
#168 cb18eef Thanks @BryceRussell! - Fix bottom padding on left sidebar
#167 990ec53 Thanks @BryceRussell! - Add bundlePath option to Pagefind configuration
4f666ba Thanks @delucis! - Fix focus outline positioning in tabs

0.1.1

Patch Changes

#155 Thanks @thomasbnt! - Add French language support
#158 92d82f5 Thanks @kevinzunigacuellar! - Fix word wrapping in search modal on narrow screens

0.1.0

Minor Changes

43f3a02 Thanks @delucis! - Release v0.1.0

0.0.19

Patch Changes

fab453c Thanks @delucis! - Design tweak: larger sidebar text with more spacing
#134 5f4acdf Thanks @Yan-Thomas! - Add Portuguese language support
8805fbf Thanks @delucis! - Add box-shadow to prev/next page links as per designs
81ef58e Thanks @delucis! - Design tweak: slightly less horizontal padding in header component on narrower viewports
8c103b3 Thanks @delucis! - Design tweak: pad bottom of page content slightly
#129 bbcb277 Thanks @delucis! - Fix bug setting writing direction from a single root locale

0.0.18

Patch Changes

a76ae4d Thanks @delucis! - Add new icons for use in starter project

0.0.17

Patch Changes

#107 2f2d3ee Thanks @delucis! - Small CSS size optimisation
#105 55fec5d Thanks @delucis! - Add <Card> and <CardGrid> components for landing pages and other uses

0.0.16

Patch Changes

#103 ccb919d Thanks @delucis! - Support adding a hero section to pages
#101 6a2c0df Thanks @TheOtterlord! - Add better error messages for starlight config

0.0.15

Patch Changes

ded79af Thanks @delucis! - Add missing skip link to 404 page
#99 d162b2f Thanks @delucis! - Fix “next page” arrow showing on pages not in sidebar
#99 d162b2f Thanks @delucis! - Add support for a “splash” layout
#99 d162b2f Thanks @delucis! - Support hiding right sidebar table of contents
#99 d162b2f Thanks @delucis! - Move edit page link to page footer so it is accessible on mobile

0.0.14

Patch Changes

#95 de24b54 Thanks @delucis! - Support translations in sidebar config
#97 2d51762 Thanks @morinokami! - Add Japanese language support

0.0.13

Patch Changes

8688778 Thanks @delucis! - Fix small CSS compatibility issue
#93 c6d7960 Thanks @delucis! - Fix default locale routing bug when not using root locale
d8a171b Thanks @delucis! - Fix autogenerated sidebar bug with index routes in subdirectories
d8b9f32 Thanks @delucis! - Fix false positive in sidebar autogeneration logic
#92 02821d2 Thanks @delucis! - Update Pagefind to latest v1 alpha
51fe914 Thanks @delucis! - Guarantee route and autogenerated sidebar sort order
116c4f5 Thanks @delucis! - Fix minor dev layout bug in Search modal for RTL languages

0.0.12

Patch Changes

#85 c86c1d6 Thanks @BryceRussell! - Improve outside click detection on the search modal

0.0.11

Patch Changes

4da9cbd Thanks @delucis! - Fix typo in English UI strings

0.0.10

Patch Changes

#78 d3ee6fc Thanks @delucis! - Add support for customising and translating Starlight’s UI.

Users can provide translations in JSON files in src/content/i18n/ which is a data collection. For example, a src/content/i18n/de.json might translate the search UI:
```
{
  "search.label": "Suchen",
  "search.shortcutLabel": "(Drücke / zum Suchen)"
}
```
This change also allows Starlight to provide built-in support for more languages than just English and adds German & Spanish support.
#76 5e82073 Thanks @lloydjatkinson! - Scale down code block font size to match Figma design
#78 d3ee6fc Thanks @delucis! - Require a minimum Astro version of 2.5.0

0.0.9

Patch Changes

#72 3dc1d0c Thanks @delucis! - Fix vertical alignment of social icons in site header
#63 823e351 Thanks @liruifengv! - Make sidebar groups to collapsible
#72 3dc1d0c Thanks @delucis! - Fix image aspect ratio in Markdown content

0.0.8

Patch Changes

#62 a91191e Thanks @delucis! - Make base support consistent, including when trailingSlash: 'never' is set.
#61 608f34c Thanks @liruifengv! - Fix toc headingsObserver rootMargin
#66 9ca67d8 Thanks @Yan-Thomas! - Make site title width fit the content
#64 4460e55 Thanks @delucis! - Fix table of contents intersection observer for all possible viewport sizes.
#67 38c2c1f Thanks @TheOtterlord! - Fix background color on select component
#57 5b6cccb Thanks @BryceRussell! - Update site title link to include locale

0.0.7

Patch Changes

#55 8597b9c Thanks @delucis! - Fix routing logic to handle index.md slug differences between docs collection root and nested directories.
#54 db728d6 Thanks @TheOtterlord! - Add padding to scroll preventing headings being obscured by nav
#51 3adbdbb Thanks @delucis! - Support displaying a custom logo in the nav bar.
#51 3adbdbb Thanks @delucis! - All Starlight projects now use Astro’s experimental optimized asset support.

0.0.6

Patch Changes

#47 e96d9a7 Thanks @delucis! - Fix CSS ordering issue caused by imports in 404 route.
#47 e96d9a7 Thanks @delucis! - Highlight current page section in table of contents.
1028119 Thanks @delucis! - Use default locale in 404.astro.
05f8fd4 Thanks @delucis! - Include initial-scale=1 in viewport meta tag.
#47 e96d9a7 Thanks @delucis! - Fix usage of aria-current in navigation sidebar to use page value.
#48 a49485d Thanks @delucis! - Improve right sidebar layout.

0.0.5

Patch Changes

#42 c6c1b67 Thanks @delucis! - Support setting custom <head> tags in config or frontmatter.

0.0.4

Patch Changes

#40 e22dd76 Thanks @delucis! - Generate sitemaps for Starlight sites
#38 623b577 Thanks @delucis! - Add tab components for use in MDX.

0.0.3

Patch Changes

1f62c75 Thanks @delucis! - Add repo, issues & homepage links to package.json
#36 62265e4 Thanks @delucis! - Collapse table of contents in dropdown on narrower viewports

0.0.2

Patch Changes

#35 ea999c4 Thanks @delucis! - Add support for social media links in the site header.
#33 833393a Thanks @MoustaphaDev! - Import zod from astro/zod to fix an issue related to importing the astro:content virtual module

0.0.1

Patch Changes

#30 dc6e04d Thanks @delucis! - Set up npm publishing with changesets

Compare Versions - @astrojs/starlight

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Upgrade Astro and dependencies

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Upgrade Astro and dependencies

Update your collections

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Upgrade Astro and dependencies

Update your collections