Documentation
A resizable sidebar with hierarchical navigation, integrated search, and version picker. Designed for reference material that users need to navigate quickly.
Best for: API docs, guides, references, wikis, knowledge bases
Beautiful, accessible, and thoughtfully designed. Tanuki makes decisions so you can focus on content.
Soothing Catppuccin pastels meet crisp Geist typography
Choose the layout that fits your content
A resizable sidebar with hierarchical navigation, integrated search, and version picker. Designed for reference material that users need to navigate quickly.
Best for: API docs, guides, references, wikis, knowledge bases
A distraction-free reading experience with full-screen chapter overlay and keyboard navigation. Maximizes content width for comfortable long-form reading.
Best for: Tutorials, e-books, courses, technical books, manuals
Card-based listing with tags, dates, and reading time estimates. Individual posts with clean typography optimized for articles.
Best for: Personal blogs, dev logs, newsletters, announcements
Full-width landing pages with hero sections, feature grids, install commands, and custom footers. Designed to showcase tools, libraries, and applications.
Best for: CLI tools, libraries, SaaS products, open source projects
Less configuration, more consistency
Built with battle-tested community favorites: Geist's elegant typography, Lucide's crisp icons, Catppuccin's soothing palette, and elasticlunr's lightning search. Why reinvent what the community has perfected?
Inspired by Nintendo's gift for making complex things feel obvious. Like Animal Crossing's gentle onboarding or Kirby's intuitive controls, everything should feel familiar and welcoming from the first moment.
JavaScript enhances, never gates. Every page works with scripts disabled. Progressive enhancement means content-first: load what matters, enhance when possible. Less is more, even when it's aesthetically delightful.
As Matz said when creating Ruby: "I hope to see Ruby help every programmer to be productive, enjoy programming, and be happy." Computers serve humans, not the reverse. Every design decision asks: does this respect the person using it?
SEO, AEO, and ARIA aren't afterthoughts—they're foundations. JSON-LD structured data, semantic HTML, and accessible markup ensure your content speaks fluently to humans, screen readers, search engines, and AI agents alike.
Technology should spark joy, not just function. Serious systems deserve playful interfaces. We refuse to lose the wonder that drew us to building things in the first place. Delight is a feature, not frivolity.
Copy a config.toml and start building
# Documentation site with sidebar and version picker
base_url = "https://docs.example.com"
title = "My Project Docs"
theme = "tanuki"
build_search_index = true
[markdown]
highlight_code = true
highlight_theme = "css"
[extra]
mode = "docs"
github = "https://github.com/you/project"
# Optional: version picker
[extra.versions]
current = "2.0.0"
list = [
{ version = "2.0.0", url = "/", label = "latest" },
{ version = "1.0.0", url = "/v1/" },
]
# E-book or tutorial with chapter navigation
base_url = "https://book.example.com"
title = "The Complete Guide"
theme = "tanuki"
build_search_index = true
[markdown]
highlight_code = true
highlight_theme = "css"
[extra]
mode = "book"
github = "https://github.com/you/book"
# Personal blog with RSS feed and tags
base_url = "https://blog.example.com"
title = "My Blog"
theme = "tanuki"
generate_feeds = true
taxonomies = [
{ name = "tags", feed = true },
]
[markdown]
highlight_code = true
highlight_theme = "css"
[extra]
mode = "blog"
# Optional: hero section
[extra.hero]
title = "Welcome to my blog"
subtitle = "Thoughts on code and craft"
# Optional: navigation
[[extra.nav]]
name = "Blog"
url = "/blog/"
[[extra.nav]]
name = "About"
url = "/about/"
# Product landing page with features and install
base_url = "https://myproduct.example.com"
title = "My Product"
description = "A powerful tool for developers"
theme = "tanuki"
[markdown]
highlight_code = true
highlight_theme = "css"
[extra]
mode = "product"
github = "https://github.com/you/project"
# Product-specific settings
[extra.product]
icon = "assets/product-icon.png"
tagline = "Built for modern developers"
install_command = "curl -fsSL get.example.com | sh"
# Navigation
[[extra.nav]]
name = "Features"
url = "#features"
[[extra.nav]]
name = "Install"
url = "#install"