Changelog

• 0.21.4

  Apr 5, 2024

  🐞 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

  Apr 1, 2024

  🐞 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

  Mar 20, 2024

  🐞 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

  Mar 4, 2024

  🐞 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

  Mar 1, 2024
  

  🍿 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

  Feb 24, 2024

  🐞 Patch Changes

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

  Feb 23, 2024
  

  🍿 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

  Feb 20, 2024

  🐞 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

  Feb 16, 2024
  

  🍿 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

  Feb 14, 2024

  🐞 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

  Feb 9, 2024
  

  🍿 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

  Feb 8, 2024

  🐞 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

  Feb 6, 2024

  🐞 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

  Jan 31, 2024

  🐞 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

  Jan 29, 2024

  🐞 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

  Jan 26, 2024
  

  🍿 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

  Jan 19, 2024
  

  🍿 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

  Jan 17, 2024

  🐞 Patch Changes

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

  Jan 9, 2024

  🐞 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

  Jan 2, 2024

  🐞 Patch Changes

  • #1254 e9659e8 Thanks @Pukimaa! - Adds Open Collective social link icon

  • #1295 c3732a9 Thanks @juchym! - Improve Ukrainian UI translations