How It Works

Connect Your GitHub

Authorize ARK95 with your GitHub account using OAuth. One click, fully secure, revocable anytime.

Private Repo Created

ARK95 automatically creates a private repository called ark95-diagrams in your GitHub account. Your data stays yours.

Commit Your Diagrams

With one click, commit any diagram as a structured JSON file. Each commit auto-increments the version number (1.1, 1.2, 1.3...).

View Full History

Browse all previous versions of each diagram directly inside ARK95. See who changed what, when, and compare versions.

Why Engineers Love This

Architecture-as-code — your diagrams live as JSON in Git, not locked in a proprietary format

Auto-versioning — every commit increments the version automatically, no manual tracking

Private by default — ARK95 creates a private repo, only you have access

Full commit history — see every change, every version, every timestamp

One-click commit — no terminal, no CLI, no merge conflicts. Just click and save

Revocable access — disconnect GitHub anytime from your dashboard

Structured JSON — each diagram file is machine-readable, ready for CI/CD pipelines and LLMs

What Gets Committed

Each diagram is exported as a clean, structured JSON file inside your private GitHub repo.

diagrams/my-architecture.json

{
  "name": "My Architecture",
  "version": "1.5",
  "exportedAt": "2026-03-23T22:00:00Z",
  "nodes": [
    { "type": "service", "subtype": "api", "name": "Gateway" },
    { "type": "database", "subtype": "sql", "name": "PostgreSQL" },
    { "type": "cache", "subtype": "redis", "name": "Session Cache" },
    { "type": "queue", "subtype": "message_queue", "name": "Events" }
  ],
  "edges": [
    { "from": "Gateway", "to": "PostgreSQL", "verb": "SELECT, INSERT" },
    { "from": "Gateway", "to": "Session Cache", "verb": "GET, SET" }
  ]
}

GitHub Integration

Version Your Architecture Diagrams with GitHub

Connect your GitHub account and commit your architecture diagrams as structured JSON. Track every change, review history, and never lose a version.

Start for free See pricing