# Architecture Diagram Generator - ShipDocs

> Paste a public GitHub, GitLab, or Bitbucket URL and get a Mermaid flowchart architecture diagram generated from the repo's actual source. Free, no signup.

**URL:** https://shipdocs.sh/tools/architecture

## What it produces

A Mermaid flowchart diagram showing:

- **Modules and directories** as nodes, grouped into architectural layers via subgraphs.
- **Dependencies** between modules as edges, labeled with the relationship type (imports, HTTP, queries, publishes, etc.).
- **Data stores** shown with the database shape (e.g. `db[(Postgres)]`).
- **Entry points** like CLI tools, workers, or API servers as distinct nodes.

The diagram is rendered visually and the Mermaid source is available to copy or edit.

## How it works

1. You enter a public repo URL.
2. ShipDocs's indexer reads the file tree and a sampled cross-section of source files (manifests, entry points, key modules).
3. An LLM analyzes the directory structure and imports to produce a Mermaid flowchart grounded in the real code.
4. The diagram is rendered in-browser. You can toggle to the source, copy the Mermaid syntax, and paste it into any Mermaid-compatible tool.

## Use cases

- **Onboarding** - give a new team member a visual overview of how the pieces fit together.
- **Pre-acquisition / due diligence** - quickly understand a target's architecture before deep review.
- **OSS evaluation** - see if a library's architecture matches your needs before adopting it.
- **Documentation** - embed the Mermaid source in your own README or wiki.

## Limits

- Public repos only.
- The diagram is a high-level summary (≤15 nodes), not a detailed class diagram.
- For per-component documentation, AI chat over your code, and private-repo support, use the full ShipDocs product: https://shipdocs.sh/.

## Pricing

Free. No signup, no credit card.