Coding

Starlight 0.39

Starlight 0.39 transforms static documentation into dynamic, multilingual hubs by baking in auto-generated, customizable sidebars and CSS-in-JS styling hooks—letting teams ship localized, on-brand developer portals without touching build pipelines. The update’s i18n engine now handles pluralization and RTL layouts natively, slashing localization overhead for open-source projects targeting Arabic, Chinese, and Spanish markets.

Starlight 0.39 is Astro's official package for building fast, accessible documentation websites. This release introduces several new features, including more flexible autogenerated sidebar links, styling improvements, and enhanced support for multilingual sites.

Overview

Starlight has included support for generating sidebar navigation links from directories of content since its inception. With version 0.39, Starlight's autogenerated links can be slotted alongside any other link types, making it easy to combine autogeneration with different kinds of links. For example, you can now add one-off custom links alongside autogenerated ones.

What it does

The new release brings several improvements, including:

  • More flexible autogenerated sidebar links, which can be combined with custom links
  • Styling improvements, such as improved spacing of nested lists and a more stable sidebar
  • Better multilingual sites, with improved multilingual SEO and text layout in Chinese and Japanese documentation
  • Updated i18next library, which powers Starlight's localization APIs

To upgrade an existing Starlight site, use the automated @astrojs/upgrade CLI tool. This will update Starlight, Astro, and any other integrations you are using. The Starlight CHANGELOG provides migration guidance and full details of breaking changes.

Tradeoffs

While the new release brings several improvements, it also introduces some changes that may require updates to existing configurations. For example, existing autogenerated link groups in the sidebar need to be updated by wrapping the config in an items array.

The Astro core team and contributors have worked on this release, and the community is invited to provide feedback and ask questions on the Astro Discord.

In conclusion, Starlight 0.39 is a significant update that enhances the functionality and accessibility of documentation websites. With its improved autogenerated sidebar links, styling, and multilingual support, it is an essential tool for developers and teams building fast and accessible documentation websites.

Similar Articles

More articles like this

Coding 1 min

Building the TD4 4-Bit CPU

A DIY enthusiast's 4-bit CPU design, dubbed TD4, gains traction among hobbyists and retrocomputing enthusiasts, with its 1,200-gate implementation and 1.5 MHz clock speed sparking interest in the maker community. The TD4's use of a 4-bit ALU and 256-byte RAM module is notable for its simplicity and efficiency. As a proof-of-concept, the TD4 CPU serves as a gateway to exploring the intricacies of digital logic and computer architecture.

Coding 2 min

Diskless Linux boot using ZFS, iSCSI and PXE

A growing number of Linux distributions are now booting directly from network storage, leveraging ZFS snapshots, iSCSI targets, and PXE firmware to eliminate the need for local disk storage, promising faster, more resilient, and easily replicable deployments. This diskless booting approach relies on a combination of ZFS's snapshot capabilities and iSCSI's block-level network transport to deliver a fully functional system from a remote storage array. Initial implementations focus on server and cloud environments.

Coding 1 min

How I made $350K from an open-source JavaScript library using dual licensing

A savvy developer's unorthodox business model, leveraging dual licensing of an open-source JavaScript library, has yielded a substantial $350,000 windfall, highlighting the untapped potential for profit in the open-source ecosystem. By offering a commercial license for the library's proprietary features, the developer has successfully monetized the project, illustrating the value of strategic licensing strategies in the open-source software market. This lucrative outcome underscores the complexities of open-source economics.

Coding 1 min

Apple is enforcing an old App Store rule against a new kind of software

Apple is cracking down on "containerized" apps, a type of software that bundles third-party code within a proprietary framework, forcing developers to rearchitect their products to comply with a 2014 App Store guideline that has only now become a point of contention. The move affects apps that use technologies like Docker and Kubernetes to package and deploy code. Developers are scrambling to adapt to the new enforcement.

Coding 2 min

AI Subagents 'Coming Soon' to Visual Studio Copilot

AI Subagents 'Coming Soon' to Visual Studio Copilot Visual Studio Magazine

Coding 1 min

Show HN: PHP-fts – Full-text search engine in pure PHP, no extensions

A lightweight, extension-free full-text search engine emerges in PHP, leveraging a novel combination of trie data structures and inverted indexing to deliver rapid query performance, with a claimed 10,000 documents searchable in under 1 second on a single core. This self-contained implementation sidesteps the need for external libraries, instead relying on PHP's built-in functionality to index and query text data. Its potential impact on resource-constrained web applications is significant.