GitHub

Manticore Sphinx Theme

A clean, elegant documentation theme for Sphinx 7+ built on Bulma CSS / SASS with zero NPM or Node.js dependencies.

Designed for corporate software documentation with an RTD-style layout, automatic dark mode, a floating on-page TOC with search, and a corporate landing page — all in 1,500 lines of modern SCSS.

Getting Started

• Installation
  • Option A — pip install (recommended)
  • Option B — Copy the theme directory
  • Option C — Reference by path
  • Runtime Files
  • Prerequisites
• Quick Start
  • 1. Install
  • 2. Configure
  • 3. Build
  • 4. Live-Reload
  • Minimal conf.py

Customisation

• Configuration
  • Colour Roles
  • Sphinx-Level Settings
  • Landing Page Cards
• Colours & Fonts
  • Colour Palette
  • Font Stack
  • Link Colours
• Corporate Branding
  • Sidebar Logo
  • Browser Favicon
  • Project Name & Version
  • Repository Link
  • Complete Branding Example
• Dark Mode
  • How It Works
  • Architecture
  • Customising Dark Mode
• Landing Page
  • Enabling the Landing Page
  • Content Layout
  • Landing Cards from conf.py
  • Mobile Behaviour
• Sidebar Directive
  • Usage
  • Image Handling
  • Float Behaviour
  • Tips
• SASS Customisation
  • Architecture
  • Workflow
  • Common Customisations
  • Pygments Style

Building & Deploying

• Build System
  • Tool Detection
  • Command Reference
  • pipx Integration
• Optimization
  • Usage
  • What It Does
  • Example Output
  • Pre-compiled CSS
• Deployment
  • GitHub Pages
  • GitLab Pages
  • Read the Docs
  • Self-Hosted (Nginx)
  • S3 / CloudFront

Reference

• Options Reference
• Keyboard Shortcuts
• Directives Support

Features

• RTD-style layout — fixed left sidebar with tree navigation

• 3-state dark mode — System / Dark / Light, persisted across pages

• Floating on-page TOC with live search filter and fold/unfold

• Corporate landing page — no sidebar, centred hero, card grid

• Sidebar directive — .. sidebar:: with images floats correctly

• Roboto font family — Medium for headings, Slab for body, Mono for code

• Full Sphinx directive coverage — every directive styled

• Responsive — mobile sidebar, touch-friendly, print stylesheet

• No NPM — compiles with dart-sass or Python libsass

• Modern SCSS — @use / @forward, CSS custom properties for dark mode

• Cross-platform build — Makefile and build.py (pure Python)

• Post-build optimization — HTML/CSS minification and gzip pre-compression

On this page

• Manticore Sphinx Theme
  • Features