Skip to content

Catppuccin for Zensical

Version Supported Python Versions Documentation License

A soothing pastel theme for Zensical documentation sites, built on the Catppuccin palette. It registers an installable catppuccin theme that extends Zensical's default theme, adding all four official flavors.

Try the toggle

Use the palette toggle in the header to cycle through Mocha, Macchiato, Frappé, and Latte. The whole site re-themes instantly — including code blocks, admonitions, and diagrams.

The four flavors

  • Mocha

    The deepest, most saturated dark scheme. The default first impression for this site.

  • Macchiato

    Slightly more vibrant than Frappé, with a touch more contrast.

  • Frappé

    A muted, cool-toned dark variant. Comfortable for low-light reading.

  • Latte

    Warm, light, easy on the eyes during the day. The light scheme.

Quickstart

Install the package alongside Zensical:

pip install catppuccin-zensical

Point your project at the theme:

zensical.toml
[project.theme]
name = "catppuccin"

That's it. By default the theme follows the visitor's system preference — Latte for light mode, Mocha for dark — with no further configuration needed.

Where to next

  • Installation — pip, uv, and version pinning.
  • Configuration — pick a single flavor, system preference, or all four with a toggle (like this site).
  • Customization — accents, fonts, and the footer signature opt-out.
  • Showcase — admonitions, code, diagrams, and more, styled in every flavor.