Skip to content
Exquisitus

Getting started

Exquisitus is a Starlight plugin. You add it to an existing Starlight site; it brings its own fonts, palette, and component refinements.

  1. Install the theme alongside Starlight.

    Terminal window
    pnpm add starlight-theme-exquisitus

  2. Register the plugin in your Starlight configuration.

    astro.config.mjs
    import starlight from '@astrojs/starlight';
    import starlightThemeExquisitus from 'starlight-theme-exquisitus';
    import { defineConfig } from 'astro/config';
    

    export default defineConfig({
      integrations: [
        starlight({
          plugins: [starlightThemeExquisitus()],
          title: 'My Docs',
        }),
      ],
    });

  3. Start the dev server and look at the result.

    Terminal window
    pnpm dev

What the plugin does

Section titled “What the plugin does”

Registering the plugin makes three changes to your site:

  1. It self-hosts three typefaces: Literata, Alegreya Sans, and JetBrains Mono get added via @fontsource, so nothing is fetched from a third-party origin.
  2. It replaces the Starlight color system with an OKLCH palette for light and dark modes. Colors are layered so your own customCss still wins.
  3. It refines the core components—header, sidebars, asides, cards, code blocks, file trees, and the hero—without changing Starlight’s markup or behavior.