Generate a Diagram from a GitHub Repository

Two ways. The quick one works without an account: paste what encodes the architecture, such as the docker-compose file, the folder tree, the README, or Terraform, and the AI draws an editable diagram from it. The deeper one is connecting the repository itself: Datadef reads the code from GitHub, suggests what the diagram should focus on based on what it actually finds, and generates the diagram plus an architecture doc for the same commit.

Once a GitHub repo is connected, Datadef re-reads it once a day and regenerates the diagram, so the picture follows the code instead of drifting. You can also trigger a refresh manually or from a coding agent through the MCP tools. Each connection targets a specific branch or tag, so a main diagram and a release diagram can live side by side. Repo sync is a paid-plan feature with a 7-day free trial, no card required.

No. A public repo connects with just its URL. A private repo needs a fine-grained personal access token with read-only scopes, and the exact scopes are listed in the repositories documentation. Datadef never writes to the repository: the generated architecture doc lives in Datadef, and when the diagram is public the doc carries a live embed line you can copy into your README so it always shows the current version.

Pasting repo content and generating diagrams works on the free plan, right in the browser. Connected repositories with daily sync and the generated architecture doc are part of the paid plans, with a 7-day free trial and no card required.