Documentation

Datadef documentation

Datadef turns a plain-English description, a pile of pasted Terraform or SQL, or a connected repository into an editable architecture diagram. The diagram is a live document: you refine it on a canvas, share it with exact permissions, embed it in READMEs and docs where it keeps itself current, and let AI agents read and edit it over MCP.

Start here

Getting started

The scratch canvas, accounts, and the 7-day trial.

Build

Generating diagrams

Prompting, pasting Terraform or SQL, scope, and allowances.

The canvas

Nodes, edges, zones, the properties panel, versions, templates.

Share

Sharing and permissions

Roles, invitations, and what a public link does and does not allow.

Embedding

Live diagram images and iframes for READMEs, docs sites, and Notion.

Keep in sync

Repositories

Diagrams generated from GitHub, GitLab, or Azure DevOps, refreshed daily.

MCP and agents

Connect Claude Code, Cursor, or ChatGPT to your diagrams.

Account

Teams and folders

Team workspaces, the 5-seat plan, and need-to-know folders.

Plans and billing

The trial, paid plans, and what happens when a plan ends.

New here? Try the scratch canvas without an account: 3 AI generations a day, saved in your browser. Signing up starts a 7-day trial of the full product, no card required.