Skip to content

Starlight Changelog

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

0.7.3

Patch Changes

0.7.2

Patch Changes

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

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

0.5.5

Patch Changes

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

0.5.4

Patch Changes