PostHog Handbook Library

An unofficial, living reader edition of PostHog's public handbook.

PostHog's handbook changes constantly, so a normal ebook would go stale. This project rebuilds the handbook from the public source, publishes fresh reader editions, and explains what changed between editions.

The live PostHog handbook remains the source of truth.

Use It

No terminal required.

• Open the searchable reader: https://dantrapp.github.io/posthog-handbook/
• Use it to search the handbook, browse by section, and download the full mobile-friendly eBook.
• Optional smaller section eBooks are available inside the reader for people who only want one topic.
• For the most current phone experience, add the reader site to your home screen. The installed web reader can cache generated pages for offline reading and refresh when a new build is published.

Downloaded eBooks are dated snapshots. They are useful in Apple Books, Kindle apps, and other offline reading apps, but they should be re-downloaded when a newer edition is published.

What It Builds

Every generated edition includes source links and a generated date.

• Complete HTML handbook library
• Searchable hosted reader site
• Installable offline-friendly web reader
• Company narrative HTML edition
• Complete-library eBook
• Company narrative eBook
• Section-level eBook volumes
• Print/PDF-ready HTML
• Downloadable HTML library ZIP
• Full source and artifact manifest
• Human-readable and JSON change digests

Living Rebuilds

GitHub Actions does the living-book work:

1. Runs on pushes, manual dispatch, and a weekly schedule.
2. Downloads the latest released manifest when one exists.
3. Rebuilds the live PostHog handbook from PostHog/posthog.com.
4. Compares the new manifest against the previous released manifest.
5. Generates Markdown and JSON change digests.
6. Publishes the reader site to GitHub Pages.
7. Publishes a dated GitHub Release with eBooks, the HTML archive, manifest, and changes.

That is the product idea: do not pretend the handbook is stable. Rebuild it, timestamp it, attribute it, and show the diff.

The living edition is the hosted reader. The eBooks are generated editions with links back to the latest reader, because EPUB files installed in book apps do not update themselves.

For Developers

Requires Node.js 22+.

npm run discover
npm run build
npm run validate
npm test

For a faster live smoke build:

npm run build:smoke

Build outputs are written to dist/. The latest complete library is also copied to dist/latest/.

CLI

npm run cli -- discover
npm run cli -- build --edition all
npm run cli -- build --edition company
npm run cli -- diff --previous old-manifest.json --current new-manifest.json
npm run cli -- validate --dist dist/latest
npm run cli -- serve --dist dist/latest

Philosophy

There is no manually maintained book here. There is only:

• PostHog's public handbook source
• a deterministic build pipeline
• dated generated editions
• clear source attribution
• manifest-based change intelligence