Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Conversation

@LexxaRRioo
Copy link
Contributor

Issue:
I've got a default dbt docs UI and had no idea how to switch to opendbt version of Data Catalog (like in Demo).

Suggestion:
Add clear docs explanation how to generate yours index.html and automate it a bit.

Context:
It was a bit frustrating to get default UI instead of your version with column-level lineage data catalog.
I've figured out that index.html has to be somewhere in the repo, but I suggest to automate and document this process for other users.

p.s. how to bump patch version in release? I've bumped pyproject.toml version

- Modified deploy_user_index_html() to fallback to opendbt's enhanced UI
- If no user-provided index.html found in docs_paths, automatically copies
  opendbt/dbt/docs/index.html to target directory
- Applies to both dbt v17 and v18 task implementations
- Users can still override by providing their own index.html in docs_paths

This change makes the enhanced catalog UI (with column-level lineage,
dependency graphs, and modern Vue.js interface) available out-of-the-box
without requiring users to manually copy files.

Note: catalogl.json generation already happens automatically via
generate_opendbt_catalogl_json() method.
- Modified deploy_user_index_html() to fallback to opendbt's enhanced UI
- If no user-provided index.html found in docs_paths, automatically copies
  opendbt/dbt/docs/index.html to target directory
- Applies to both dbt v17 and v18 task implementations
- Users can still override by providing their own index.html in docs_paths
- Added comprehensive documentation on generating and customizing catalog UI
- Bumped version to 0.14.2

This change makes the enhanced catalog UI (with column-level lineage,
dependency graphs, and modern Vue.js interface) available out-of-the-box
without requiring users to manually copy files.

Usage: python -m opendbt docs generate

Note: catalogl.json generation already happens automatically via
generate_opendbt_catalogl_json() method.
@ismailsimsek ismailsimsek merged commit c0176d5 into memiiso:main Oct 23, 2025
16 checks passed
@ismailsimsek
Copy link
Member

Great improvements for docs. Thank you @LexxaRRioo merged

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants