fix(deps): update dependency @astrojs/starlight to v0.37.0 #403

renovate · 2025-07-16T21:03:47Z

This PR contains the following updates:

Package	Change	Age	Confidence
@astrojs/starlight (source)	`0.34.8` -> `0.37.0`

Release Notes

withastro/starlight (@astrojs/starlight)

`v0.37.0`

Compare Source

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.

`v0.36.3`

Compare Source

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

`v0.36.2`

Compare Source

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

`v0.36.1`

Compare Source

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

`v0.36.0`

Compare Source

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>

`v0.35.3`

Compare Source

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>

`v0.35.2`

Compare Source

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.

`v0.35.1`

Compare Source

Patch Changes

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

`v0.35.0`

Compare Source

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.

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

cloudflare-workers-and-pages · 2025-07-16T21:04:02Z

Deploying with Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	astro-tips	`630448a`	Commit Preview URL Branch Preview URL	Dec 01 2025, 07:17 PM

renovate bot changed the title ~~fix(deps): update dependency @astrojs/starlight to v0.35.0~~ fix(deps): update dependency @astrojs/starlight to v0.35.1 Jul 18, 2025

renovate bot force-pushed the renovate/astrojs-starlight-0.x branch from 92f5f6f to d34f665 Compare July 18, 2025 11:04

renovate bot force-pushed the renovate/astrojs-starlight-0.x branch from d34f665 to 33df94f Compare August 5, 2025 15:37

renovate bot changed the title ~~fix(deps): update dependency @astrojs/starlight to v0.35.1~~ fix(deps): update dependency @astrojs/starlight to v0.35.2 Aug 5, 2025

renovate bot force-pushed the renovate/astrojs-starlight-0.x branch from 33df94f to b95d19e Compare August 13, 2025 05:55

renovate bot changed the title ~~fix(deps): update dependency @astrojs/starlight to v0.35.2~~ fix(deps): update dependency @astrojs/starlight to v0.35.3 Sep 14, 2025

renovate bot force-pushed the renovate/astrojs-starlight-0.x branch 2 times, most recently from 80e8798 to eade76f Compare September 19, 2025 18:45

renovate bot changed the title ~~fix(deps): update dependency @astrojs/starlight to v0.35.3~~ fix(deps): update dependency @astrojs/starlight to v0.36.0 Sep 19, 2025

renovate bot force-pushed the renovate/astrojs-starlight-0.x branch from eade76f to 1aa5320 Compare October 15, 2025 18:15

renovate bot changed the title ~~fix(deps): update dependency @astrojs/starlight to v0.36.0~~ fix(deps): update dependency @astrojs/starlight to v0.36.1 Oct 15, 2025

renovate bot force-pushed the renovate/astrojs-starlight-0.x branch from 1aa5320 to 2957fa8 Compare October 21, 2025 09:44

renovate bot force-pushed the renovate/astrojs-starlight-0.x branch from 2957fa8 to 7f5a26a Compare October 31, 2025 21:29

renovate bot changed the title ~~fix(deps): update dependency @astrojs/starlight to v0.36.1~~ fix(deps): update dependency @astrojs/starlight to v0.36.2 Oct 31, 2025

renovate bot force-pushed the renovate/astrojs-starlight-0.x branch from 7f5a26a to e192e20 Compare November 27, 2025 21:28

renovate bot changed the title ~~fix(deps): update dependency @astrojs/starlight to v0.36.2~~ fix(deps): update dependency @astrojs/starlight to v0.36.3 Nov 27, 2025

fix(deps): update dependency @astrojs/starlight to v0.37.0

630448a

renovate bot force-pushed the renovate/astrojs-starlight-0.x branch from e192e20 to 630448a Compare December 1, 2025 19:15

renovate bot changed the title ~~fix(deps): update dependency @astrojs/starlight to v0.36.3~~ fix(deps): update dependency @astrojs/starlight to v0.37.0 Dec 1, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

fix(deps): update dependency @astrojs/starlight to v0.37.0 #403

fix(deps): update dependency @astrojs/starlight to v0.37.0 #403

Uh oh!

renovate bot commented Jul 16, 2025 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages bot commented Jul 16, 2025 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

fix(deps): update dependency @astrojs/starlight to v0.37.0 #403

Are you sure you want to change the base?

fix(deps): update dependency @astrojs/starlight to v0.37.0 #403

Uh oh!

Conversation

renovate bot commented Jul 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release Notes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Patch Changes

Patch Changes

Patch Changes

Minor Changes

Patch Changes

Configuration

Uh oh!

cloudflare-workers-and-pages bot commented Jul 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying with Cloudflare Workers

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

renovate bot commented Jul 16, 2025 •

edited

Loading

cloudflare-workers-and-pages bot commented Jul 16, 2025 •

edited

Loading