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, the free daily allowance, and what Pro adds.

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

What is free, what Pro and Team include, the trial, and cancelling.

New here? Try the scratch canvas without an account: 1 AI diagram and 2 AI edits a day, saved in your browser. Pro includes everything else, and starts with a 7-day free trial.