Skip to content

Theme studio

Build a Blasdoc theme

Every value the default theme paints is a --blasdoc-* custom property, so a theme is a block of CSS. Change what you want here, take the stylesheet, and leave the rest following Blasdoc's own defaults.

Presets

Installing a theme

A theme is a stylesheet. Put it beside your global CSS, import it, and every --blasdoc-* value below follows from it. Nothing is forked, and the tokens you leave alone keep following the defaults.

app.config.ts
import { provideBlasdocTheme } from '@blasdoc/theme-default';

export const appConfig: ApplicationConfig = {
  providers: [provideBlasdocTheme()],
};

What each token reaches

TokenReachesOptional
--blasdoc-code-bgThe code panelno
--blasdoc-table-borderTable rules and its outlineno
--blasdoc-step-marker-bgThe numbered discyes

Save the file

Put it beside your global stylesheet, as src/blasdoc-theme.css.

Install it

npx @blasdoc/cli theme install src/blasdoc-theme.css

Status: stable

Save it as my-theme.css and install it with npx @blasdoc/cli theme install my-theme.css — or add the @import by hand. The full token list is on Theming.