catppuccin-zensical 0.2.0

Catppuccin theme extension for Zensical

Catppuccin Zensical

A Zensical theme extension based on the Catppuccin palette.

This package registers an installable theme named catppuccin. It extends Zensical's default Material-compatible theme and adds Catppuccin color schemes for Latte, Frappe, Macchiato, and Mocha.

The default configuration follows the user's system preference with Latte for light mode and Mocha for dark mode.

Live documentation includes installation, configuration, customization, and showcase examples.

Usage

Install the package in the same environment as Zensical:

pip install catppuccin-zensical

For local development from this checkout:

uv pip install -e .

Then set the theme name in zensical.toml:

[project.theme]
name = "catppuccin"

Or in mkdocs.yml:

theme:
  name: catppuccin

To choose a specific flavor, override the palette:

theme:
  name: catppuccin
  palette:
    scheme: catppuccin-macchiato
    primary: custom
    accent: custom

Available schemes:

• catppuccin-latte
• catppuccin-frappe
• catppuccin-macchiato
• catppuccin-mocha

Footer signature

The theme adds a small "Styled with catppuccin-zensical" line to the footer that links to the live documentation. To opt out, set:

[project.extra.catppuccin]
signature = false

Or in mkdocs.yml:

extra:
  catppuccin:
    signature: false