Starlight Site Graph Changelog

This page documents the changes made to the Starlight Site Graph. For the most up-to-date information, refer to the changelog of the individual releases on the GitHub releases page.

0.5.0 (2025/08/31)

Features

• Filter out links in HTML elements based on CSS-like selectors with the ignoreLinksInSelectors setting
  • Supports tags (footer), classes (.some-class) and IDs (#some-id)
  • Replaces the ignoreStarlightLinks setting, which is now deprecated
• Filter out nodes in the graph based on glob patterns with the nodeInclusionRules setting
  • Supports negation with !, e.g. ["**/*", "!**/drafts/**"] to exclude all pages in the drafts folder
  • By default, all pages are included (["**/*"])

Changes

• Adapt to use same slugging library as Astro
• sitemap.json is now minified and only adds fields for necessary data, reducing its size
• Improve styling of the graph when minimized and full screen
• Automatically enable the prefetch if not set, which prevents the site from completely failing to build

Fixes

• Improve compatibility with vanilla Astro, make sure to read the Getting Started guide in the docs
• Fix backlinks component not including all links to the page
• Prevent a malformed CSS variable or unsupported color space from breaking the graph rendering
• Fix a bug where the fullscreen graph would incorrectly take up the entire screen in some themes
• Prioritize stylesheets defined by the user over those provided by this package, to avoid possible @layer conflicts

0.4.1 (2025/07/16)

Fixes

• Fix unicode characters in paths not being correctly encoded in the sitemap, causing the graph and backlinks not to be visible for a page, despite an entry existing in the sitemap.

0.4.0 (2025/07/02)

Changes

• ⚠️ Breaking change: All classes provided by this package are now prefixed with slsg- to avoid conflicts with other packages.
  • If you have written custom CSS that targets the classes provided by this package, you will need to update them to use the new prefix.

Features

• Support custom slug frontmatter field in the sitemap and graph components, allowing you to define custom URLs for pages.
• Added the pageTitleFallbackStrategy configuration option, which allows you to define what the name of a page should be when the title frontmatter field is not set.
  • linkText (default): Use the most common text of the links pointing to the page.
  • slug: Use the final slug of the page, as defined by the slug frontmatter field or the URL.

Fixes

• Fix an issue where HTML links in generated content were never getting parsed
• Prevent links to sections on a page creating invalid sitemap entries

0.3.3 (2025/05/22)

Features

• Added the overridePageSidebar flag to the plugin configuration, enabling you to completely disable the plugin’s sidebar override, which normally adds the <PageGraph> and <PageBacklinks> components to the sidebar.
• Added the ability to quickly disable either the <PageGraph> or <PageBacklinks> component in the sidebar by setting the graph and/or backlinks flags to false in the plugin configuration.

Fixes

• Prevent the graph from taking up the full width of the vanilla Starlight sidebar, leading to the sidebar being much wider than the page content.

0.3.2 (2025/05/09)

Upgrades

• Switch all CSS provided by this package to a CSS cascade layer.
  • The theme now exists on the sitegraph layer, added after the base starlight layer.
  • Styles added by this package can now be more easily overridden with custom CSS.

Fixes

• Made the package version constraint less stringent, making npm less likely to throw a peer dependency error when installing the package.
• Catch cases where an unloaded CSS variable gets passed to chroma, causing a minor error in the console.

0.3.1 (2025/05/02)

Upgrades

• The minimum supported version of Starlight is now 0.33.0 due to a change in the social link syntax.

0.3.0 (2025/03/21)

Upgrades

• ⚠️ Minor change: The minimum supported version of Starlight is now 0.32.0, and Astro 5.5.0.
  No breaking changes are introduced in this upgrade, but it is recommended to update component overrides snippets that were provided by this plugin: please remove the following lines:

  ---
  import type { Props } from '@astrojs/starlight/props';
  import Default from "@astrojs/starlight/components/PageSidebar.astro";
  ---
  
  <Default {...Astro.props}><slot /></Default>
  <Default><slot /></Default>

Fixes

• Allow for the plugin configuration to be defined partially, instead of throwing an error
• Respect Astro’s trailingSlash configuration for sitemap generation and link following
• Resolve mismatching Astro dependency versions due to old astro peer-dependency of astro-integration-kit
• Bug flag not being parsed correctly, resulting in a spurious pixi-stats missing error

0.2.2 (2025/01/23)

Upgrades

• The minimum supported version of Starlight is now 0.31.0, and Astro 5.1.5.

0.2.1 (2025/01/23)

Fixes

• CSS color variables for graph nodes not supporting color spaces other than rgb and rgba
• Re-add missing gray-matter dependency

0.2.0 (2025/01/22)

Upgrades

• ⚠️ BREAKING CHANGE: The minimum supported version of Starlight is now 0.30.0.
  Please follow the upgrade guide to update your project.
  Note that the legacy.collections flag is not supported by this plugin and you should update your collections to use Astro’s new Content Layer API.

0.1.11 (2024/12/12)

Fixes

• Backlinks not being visible when graph component is hidden in sidebar

0.1.10 (2024/12/9)

Fixes

• Page backlinks not being generated in production websites

0.1.9 (2024/11/13)

First official release of the package
Older versions can be found in the releases but are not recommended for use.