MkDocs DAP Theme

A beautiful, production-ready MkDocs theme. Built for developers who want great-looking documentation without sacrificing control.

Features

  • Dark & Light mode — user-toggleable, persisted across sessions, no flash on load
  • 6 accent colors — purple, green, cyan, pink, orange, red; each adapts to both schemes
  • Two independent navigation menus — sidebar (from MkDocs nav) and a top bar with unlimited nested dropdowns
  • Collapsible sidebar — unlimited nesting depth, smooth animation, active-page auto-expand
  • Syntax highlighting — full Pygments color map for both dark and light modes
  • SEO ready — meta tags, Open Graph, Twitter Cards, JSON-LD, canonical URL
  • Google Analytics — GA4 and Universal Analytics, with GDPR/LOPD cookie consent banner
  • Fully modular — every component lives in its own CSS and JS file
  • i18n — English and Spanish built-in, easy to extend
  • GitHub button — live star count fetched from the GitHub API
  • Copy code button — appears on hover on every code block

Quick start

pip install mkdocs pymdown-extensions

Place the themes/dap folder next to your mkdocs.yml, set theme: {name: null, custom_dir: themes/dap}, and run:

mkdocs serve

See Installation for the full step-by-step guide.

License

MIT — free to use, modify, and distribute.

Consider keeping the "Designed by" credit in the footer <3.