Skip to content
A fast, modern Sphinx theme with dark mode, full-text search, and Alpine.js interactivity. Star on GitHub ★

sphinx-design

sphinx-design adds cards, grids, tabs, badges, buttons, and dropdowns. Lumina styles all of these components with its own design language.

Setup

uv add sphinx-design
conf.py
extensions = ["sphinx_design"]

What You Get

Cards

Contained content blocks with optional headers, footers, and links.

Cards & Grids
Grids

Responsive layouts with configurable columns per breakpoint.

Cards & Grids
Tabs

Tabbed content panels for grouping related information.

Code Blocks
Badges

Inline status labels with color variants.

Badges & Buttons
Buttons

Styled link buttons with primary and secondary variants.

Badges & Buttons
Dropdowns

Collapsible content sections.

Admonitions