I want to programmatically generate ERDs for my database and API schemas. The CI integration pattern in dbdocs is perfect for being able to auto-generate these ERDs. However, I would like to embed those ERDs in other HTML pages. I noticed this is currently possible with dbdiagram.io but it’s not clear whether it’s possible in dbdocs.io.
Thanks for asking Sherif. This is indeed an interesting use of dbdocs.
Could you share a little bit more details about your use case: Where do you want to embed it into? Who are the users of the HTML pages? etc… This helps us understand and plan for it better.
@huy I work at airbyte.com . We build integrations with external APIs and offer a data movement (ETL) product. Our product allows customers to move data from APIs like Stripe and databases like Postgres to warehouses like Snowflake. I would like to programmatically generate ERDs for each of my integrations so that I can show users what to expect in the destination database when they move data from a given API (instead of just redirecting them to e.g the Stripe API docs).
Functionally speaking I am looking for exactly the same embedding functionality available in dbdiagram today, but instead to embed the ERD from dbdocs project because I can programmatically generate ERDs in dbdocs. Using embedded links from dbdiagram is intractable because I would need to manually keep each of them up to date.
Does this help? Is there any way to achieve this today?
Thanks for the remind Sherif. This is indeed an interesting use case. And you also highlight clearly the pros/cons between dbdiagram and dbdocs: dbdiagram supports embedding but doesn’t have CLI/API and the wiki view of dbdocs.
We’re actually looking into merging these 2 products together, so that all functionalties will be available in a single place: Edit diagram/doc, API to update diagram/doc, wiki view + ERD view, embedding.
Right now the ETA/timeline for this is still unclear as we’re still hashing out the details.
Are you looking to integrate this for your OSS version or the SaaS/cloud offering?
We are now in the design phase of combining these two products. The announcement will be made soon. You’ll get more information and a timeline for the merger.
This embedding feature is in our roadmap and is highly prioritized. Though the release timeline is uncertain for now, but your feedbacks are extremely helpful for us:
(1) What are the tools are you looking to embed dbdocs into? (Notion, Confluence, etc.)
(2) Aside from ERDs, which other section of dbdocs do you want to embed? (The whole project, a table view, the diagram, etc.?)
If you want to contribute ideas to this feature, please feel free to have quick chitchat with me by booking a meeting via this link.
dbdocs currently does not have embedding feature yet, we’re still developing it (roadmap).
For ERDs embedding, you can use dbdiagram instead - combined with dbdiagram’s API if you want some automation. Please let me know if it works for you.
If you’re still having questions related to this, feel free to book me a call via this link.