Exquisitus for Starlight

Exquisitus is an open-source Starlight documentation theme for Astro that wraps a typography-focused, readability-driven design into a single plugin.

What is Exquisitus for Starlight?

Exquisitus is a theme plugin for Starlight, the documentation framework built on Astro. It takes a standard Starlight site configuration as input and produces a fully styled documentation site with emphasis on typographic quality and visual comfort. The theme is published as the npm package starlight-theme-exquisitus, installed with pnpm, and integrated by adding it to the plugins array in astro.config.mjs.

The project is maintained as a monorepo with two parts: packages/starlight-theme-exquisitus/, which holds the published theme, and docs/, which is a showcase site for development and preview. Alongside code, the repository includes PRODUCT.md and DESIGN.md, design-intent documents that explain the thinking behind the theme. The theme is MIT-licensed, while its bundled typefaces are covered by the separate SIL Open Font License.

Key Features

Exquisitus's features are centered on a simple integration path, a readable default design, and licensing that suits most open-source and commercial projects.

• Plugin-based installation — Run pnpm add starlight-theme-exquisitus, import starlightThemeExquisitus, and add it to the plugins array in your Starlight config; no CSS overrides are required to get the base look.
• Readability-first design — The theme's stated goal is to treat readability and beauty as the same discipline, making typography the primary visual system.
• Bundled design documentation — The repo's PRODUCT.md and DESIGN.md record the product and design rationale, giving adopters insight into the system's underpinnings.
• MIT license for the theme — Use it freely in personal and commercial work; the theme's code carries no copyleft restrictions.
• Separately licensed typefaces — Fonts bundled with the theme are distributed under the SIL Open Font License, which permits free use with its own conditions.
• Showcase site included — The docs/ directory provides a working Starlight site for previewing the theme and testing changes.
• Pinned modern toolchain — Development uses Node 24 and pnpm 11, pinned with mise.toml, with scripts pnpm dev, pnpm build, and pnpm preview.
• Generated design files — The design documentation is generated with a toolchain described as the "Impeccable" agent skill in the repository's README.

Who should use Exquisitus for Starlight?

Exquisitus is for teams and individuals who run Astro-based Starlight documentation sites, from product docs to personal knowledge bases, and want a refined typographic appearance without building a custom theme.

• Open-source project maintainers — Publish project documentation with a polished look under a permissive MIT license.
• Developer experience teams — Ship product or API documentation that reads well, relying on typography rather than elaborate visuals to carry the design.
• Independent creators — Spin up a quick Starlight site for a blog or knowledge base with a carefully chosen base theme.

Use cases

Exquisitus can be applied to any Starlight content project because it plugs into Starlight's standard page structure, navigation, and search.

• Product documentation: Wrap a Starlight docs site with the theme to get readable long-form pages for user guides and API references.
• Project knowledge base: Use the bundled showcase site as a starting point for internal or public documentation that benefits from a consistent typographic voice.
• Theme development reference: Inspect the docs/ showcase site to see how the design system renders and experiment with adjustments before applying it to your own project.

How does Exquisitus for Starlight work?

Exquisitus follows Starlight's plugin pattern: after installation, you import the default export from starlight-theme-exquisitus and include it in the plugins array of your Starlight configuration. The plugin then applies its theme to every page Starlight generates. To develop or preview locally, the monorepo uses pnpm dev, which starts the showcase site at http://localhost:4321.

Pricing

Exquisitus is free and open source under the MIT License. The bundled typefaces are separately licensed under the SIL Open Font License, which is also free to use but carries its own attribution and redistribution terms.

FAQ

Is Exquisitus for Starlight free?

Yes. The theme code is MIT-licensed, so you can use it in commercial and personal projects at no cost. The bundled typefaces are covered by the SIL Open Font License, which also permits free use under specific conditions.

What does Exquisitus for Starlight do?

It is a Starlight theme plugin that changes the default appearance of an Astro Starlight documentation site, applying a typography-first design intended to make documentation easier and more pleasant to read.

How do I install Exquisitus for Starlight?

Install the npm package starlight-theme-exquisitus with pnpm, then import it in your Astro config and add it to the Starlight plugins array. No further configuration is required to start with the default look.

Does Exquisitus for Starlight include an example site?

Yes, the repository ships a docs/ directory that serves as a showcase and development site. Running pnpm dev from the repository root launches it at http://localhost:4321.

What Node and package manager versions does Exquisitus for Starlight use?

The toolchain is pinned to Node 24 and pnpm 11 in mise.toml. The documented commands are pnpm dev, pnpm build, and pnpm preview.