dbdocs 0.0.0

Alternative dbt docs site: Catalog + ERD + column-level lineage

An alternative dbt docs site — catalog + ERD + column-level lineage, baked into one file.

Turn your dbt artifacts into a single self-contained index.html: a browsable catalog, an interactive lineage DAG and ERD, and column-level lineage from your compiled SQL. No server, no database, no build step — just a file you can open or host anywhere.

Catalog	Model page	Lineage DAG

Install

pip install dbdocs --upgrade

Requires Python 3.10+.

Quickstart

dbt docs generate     # writes target/manifest.json + target/catalog.json
dbdocs generate       # builds ./site/index.html with all data baked in
dbdocs serve          # static http server on http://127.0.0.1:8000

Full walkthrough, configuration, and architecture live in the documentation.

Why dbdocs?

dbt's own docs are great until you want lineage at the column level — that's the gap this fills. Everything is derived from your dbt manifest.json / catalog.json and baked into one offline-friendly SPA: catalog navigation grouped by database/schema, per-model SQL and columns, interactive React Flow graphs, column-level lineage via sqlglot, client-side search, a dark/light theme, and versioned deploys with a built-in version switcher.

See the docs for the deep dives.

Contributing

Contributions are welcome — bugs, features, docs, typos. See the Contributing Guide.

If dbdocs saves you some clicks, consider buying me a coffee.

License

MIT © Dat Nguyen