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 Material-compatible default, 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.