# Directory Submission Kit — Archigram

Last updated: 2026-05-02

Use these variants for launch directories, AI tool directories, MCP registries, and developer communities. Do not submit the same description everywhere.

## Core Facts

- Product: Archigram
- URL: https://archigram.me
- GitHub: https://github.com/isatimur/archigram.ai
- Category: AI architecture diagram generator
- License: MIT
- Pricing: Free to start
- Formats: Mermaid, PlantUML, BPMN
- AI provider: Google Gemini
- Auth/sync: Optional Firebase Google Auth and Firestore
- Agent surface: CLI and MCP server

## Startup / Launch Directory Variant

Tagline: AI architecture diagrams from plain English.

Short description: Create editable architecture diagrams from text.

Long description:
Archigram is the easiest way for engineers to turn system descriptions into editable architecture diagrams. Describe a microservice, cloud system, API flow, or data pipeline, then edit the generated Mermaid, PlantUML, or BPMN source in a live diagram studio.

Unlike drag-and-drop diagramming tools, Archigram keeps the diagram as source code. That makes diagrams easier to review in pull requests, copy into documentation, export as SVG/PNG, or keep next to the codebase.

Archigram is open-source, free to start, and self-hostable with a Gemini API key. Optional Firebase configuration adds Google sign-in and Firestore sync.

Tags: AI, developer tools, architecture diagrams, Mermaid, open source, system design, documentation, diagram generator.

## AI Directory Variant

Tagline: AI-powered diagramming for software architecture.

Short description: Generate Mermaid, PlantUML, and BPMN with AI.

Long description:
Archigram uses Google Gemini to generate editable architecture diagrams from plain-English prompts. Engineers can ask for cloud architecture, microservice maps, API sequence diagrams, ER diagrams, ML pipelines, or business workflows, then refine the generated source code in the editor.

AI features include text-to-diagram generation, image-to-diagram conversion, diagram syntax repair, and architecture audit prompts. Archigram supports Mermaid, PlantUML, and BPMN, with SVG/PNG export and shareable links.

The project is open-source and can run locally with a Gemini API key. Hosted accounts can use Firebase Google Auth and Firestore sync.

Tags: AI diagram generator, text to diagram, Mermaid AI, software architecture, Gemini, PlantUML, BPMN, developer tools.

## MCP / Agent Registry Variant

Tagline: MCP diagram generation for AI agents.

Short description: Generate architecture diagrams from MCP clients.

Long description:
Archigram includes an MCP server that lets AI agents generate architecture diagrams from natural-language prompts. Agents in Cursor, Claude Desktop, and other MCP-compatible clients can call `generate_diagram` to create Mermaid source and `get_diagram` to fetch public diagrams.

The MCP server can use Archigram's hosted API or a local `GEMINI_API_KEY`. This makes it useful for agents that need to produce architecture docs, pull-request diagrams, system design explanations, or implementation plans.

Installation: `bun run mcp-server`

Docs: https://github.com/isatimur/archigram.ai

Tags: MCP, AI agent, Model Context Protocol, Mermaid, architecture diagrams, developer tools, CLI, open source.

## Developer Community Variant

Tagline: Code-first diagrams for architecture docs.

Short description: Open-source AI diagramming with Mermaid source.

Long description:
Archigram is an open-source React and TypeScript app for AI-assisted architecture diagramming. The core idea is simple: diagrams should stay as source code so engineers can review, diff, copy, and keep them in docs.

The app supports Mermaid, PlantUML, and BPMN. It includes a browser editor, Gemini-powered generation, SVG/PNG export, compressed share links, a CLI, REST API routes, and an MCP server for AI agents.

Run locally with Bun and a Gemini key, or add Firebase for Google auth and Firestore sync.

Tags: React, TypeScript, Vite, Mermaid, Gemini, Firebase, MCP, open source.

## Product Hunt Draft

Name: Archigram

Tagline: AI architecture diagrams from plain English

Description:
Describe a system and get editable Mermaid, PlantUML, or BPMN diagrams. Archigram is open-source, self-hostable, and built for engineers who want diagrams they can keep with docs and code.

First comment:
I built Archigram because architecture diagrams often become stale screenshots. The useful artifact is the source: Mermaid, PlantUML, or BPMN that can be edited, reviewed, copied, and exported.

What to try:

1. Create a diagram from a plain-English system prompt.
2. Edit the generated source.
3. Export SVG/PNG or copy Mermaid into GitHub/Notion/docs.
4. Try the CLI or MCP server if you work with AI agents.

I'd value feedback on the editor flow, self-hosting docs, and which diagram templates we should add next.