Documentation Portal

Documentation
that writes itself.

Trailhead scans your codebase, reads your commits, and generates living documentation that never goes stale. Self-hosted on your infrastructure. Powered by local AI.

Deploy Trailhead See How It Works
0
Cloud deps
239
Repos indexed
<2s
Rebuild time
100%
Your servers
Features

Every doc, always current

01

Auto-generated from code

Trailhead reads your source files, function signatures, types, and comments. It produces structured API references without you writing a word.

02

Commit-aware updates

Every push triggers a doc rebuild. Changed a function? The docs update. Renamed a module? Cross-references fix themselves.

03

Full-text search

FTS5-powered search across all your docs, code examples, and changelogs. Results in under 50ms. Works offline.

04

Local AI summaries

Ollama generates plain-English summaries for every module, class, and function. No data leaves your network.

05

Version-pinned docs

Browse docs for any version, branch, or tag. Compare API changes between releases. Never wonder what changed.

06

Multi-repo support

One Trailhead instance covers your entire org. 239 repos, one search bar. Unified navigation across every project.

How It Works

Three steps to living docs

Point Trailhead at your repos

Give it a Gitea or GitHub URL, a local path, or a directory of repos. Trailhead clones, indexes, and builds a doc tree from your source code in seconds.

AI enriches the raw structure

Local Ollama models write summaries, generate usage examples, and flag undocumented public APIs. You review and approve or let it auto-publish.

Webhooks keep it fresh

Gitea and GitHub webhooks trigger incremental rebuilds on every push. Docs stay current without any manual intervention. Set it and forget it.

# Deploy Trailhead on your Pi or server
br trailhead init --repos ~/orgs/**
br trailhead build
br trailhead serve --port 3200

# Add a webhook for auto-rebuild
br trailhead webhook --gitea https://git.blackroad.io
Comparison

Why not Docusaurus or ReadTheDocs?

Feature
Others
Trailhead
Auto-generate from code
Manual MDX files
Automatic from source
AI summaries
Not available
Local Ollama, private
Hosting
Vercel / RTD cloud
Self-hosted, your infra
Multi-repo
One site per repo
Unified across all repos
Search
Algolia (cloud)
FTS5 (local, instant)
Price
$0-$400/mo
Free, self-hosted
Get Started

Deploy in 60 seconds

Trailhead runs on any Linux box, Raspberry Pi, or container. No cloud account needed. No build pipeline to configure. Just point it at your code.

# Install via BlackRoad OS
br install trailhead

# Or run standalone
git clone https://git.blackroad.io/blackroad/trailhead
cd trailhead && ./deploy.sh
Get BlackRoad — $99/mo