# Architext

> Architext turns code and infrastructure-as-code (docker-compose, Kubernetes,
> CloudFormation, Terraform), a GitHub repository, or a plain-English prompt into
> editable architecture diagrams and governance-grade solution-architecture
> documents: context diagram, architecture decision records (ADRs),
> non-functional requirements (NFRs), a RAID log, a starter threat model, and
> cost notes — plus per-audience slide decks. Everything derives from one
> queryable graph model, so the diagram, the document, and the decks stay
> consistent. Exports: PNG, SVG, Mermaid, JSON, Markdown, PowerPoint.

Key facts:
- Target users: solution architects and platform/infrastructure engineers.
- Free to create and view diagrams; a one-time $1 unlock enables all exports;
  team workspaces are available for organizations.
- No signup required to start; diagrams stay in the browser until sign-in.
- Private GitHub repos import via "Sign in with GitHub".
- Public read-only share links (/share/<token>) and embeddable diagrams
  (/embed/<token>) are available for any diagram.

## For AI assistants — create a diagram with just a link (no tools needed)

Full instructions with examples: https://architext.ai/ai

Any assistant can hand a user an Architext diagram by emitting a URL.
Prefer the clean viewer https://architext.ai/view (diagram only, with an "Edit in
Architext" button); https://architext.ai/app opens straight into the full editor.
Two payload forms — choose by your capabilities:
- IF YOU CAN EXECUTE CODE (Python/JS tool): #doc=BASE64URL — url-safe base64
  (+/ -> -_, no padding) of the doc JSON, COMPUTED with your code tool. Never
  write base64 from memory/prediction: it will be silently corrupt.
- IF YOU CANNOT EXECUTE CODE: #docjson=PERCENT_ENCODED_JSON — the doc JSON,
  compact (no whitespace), percent-encoded (at minimum: " as %22, spaces in
  labels as %20, # as %23, & as %26). Example:
  https://architext.ai/view#docjson=%7B%22name%22%3A%22Demo%22%2C%22graph%22%3A...%7D Only "name" and "graph" are required. Every id
referenced by a node/edge must exist. Example (a valid, complete document):
{"name":"My system","graph":{
"nodeTypes":{"nt1":{"id":"nt1","handle":"service","name":"Service","fields":[],
"style":{"shape":"rounded","color":"#3b82f6"},"container":false}},
"relTypes":{"rt1":{"id":"rt1","handle":"calls","name":"calls","directed":true,
"style":{"color":"#9ca3af"}}},
"nodes":{"n1":{"id":"n1","handle":"web","typeId":"nt1","label":"Web",
"values":{},"position":{"x":0,"y":0}},
"n2":{"id":"n2","handle":"api","typeId":"nt1","label":"API",
"values":{},"position":{"x":300,"y":0}}},
"edges":{"e1":{"id":"e1","relTypeId":"rt1","source":"n1","target":"n2"}}}}.
Containers: set "container":true on a type and "parentId" on child nodes
(child positions are relative to the parent) to create subsystems users can
open. Opening the link loads the diagram in the editor, fully editable; the
user can then export (PNG/SVG/PowerPoint) or create a public share link.

## For AI agents (MCP)

Architext exposes a Model Context Protocol server at https://architext.ai/api/mcp
(streamable HTTP; authenticate with "Authorization: Bearer <api key>").
Tools: import_infrastructure (IaC text -> architecture graph),
import_github_repo (public repo -> graph), generate_sad (graph ->
solution-architecture document in Markdown), create_share_link (graph ->
public share + embed URLs). Typical flow: import -> generate_sad ->
create_share_link. API keys are issued to paid users.

## Main pages

- [Architext](https://architext.ai/): product overview
- [Open the app](https://architext.ai/app): the editor — create a diagram from IaC, a repo, or a prompt
- [Architecture diagram guides](https://architext.ai/diagrams): per-stack and per-artifact guides
- [Blog](https://architext.ai/blog): practical guides for solution architects

## Guides

- [Kubernetes architecture diagrams, generated from your manifests](https://architext.ai/diagrams/kubernetes-architecture-diagram): Create a Kubernetes architecture diagram automatically. Paste your manifests or import a repo and Architext maps deployments, services, ingress, and datastores.
- [AWS architecture diagrams, generated from your infrastructure-as-code](https://architext.ai/diagrams/aws-architecture-diagram): Generate an AWS architecture diagram from CloudFormation or Terraform. Architext maps your resources and dependencies into an editable, presentable diagram.
- [Terraform architecture diagrams from your HCL](https://architext.ai/diagrams/terraform-architecture-diagram): Visualize Terraform configurations as an architecture diagram. Architext parses your HCL into editable nodes and relationships you can document and export.
- [Microservices architecture diagrams, built fast](https://architext.ai/diagrams/microservices-architecture-diagram): Design a microservices architecture diagram with an AI co-editor. Model services, queues, and datastores, then document and export — free to start.
- [Docker Compose diagrams from your compose file](https://architext.ai/diagrams/docker-compose-diagram): Turn docker-compose.yml into an architecture diagram. Architext maps services, networks, and volumes into an editable diagram you can document and export.
- [Solution architecture documents, generated from your diagram](https://architext.ai/diagrams/solution-architecture-document): Generate a solution architecture document (SAD) from your diagram: context, decisions/ADRs, NFRs, RAID, threat model, and cost — then export or present it.
- [Azure Architecture Diagram](https://architext.ai/diagrams/azure-architecture-diagram): Diagram your Microsoft Azure architecture — resource groups, app services, AKS, storage, and the dependencies between them — and keep it editable. Build it wi
- [Gcp Architecture Diagram](https://architext.ai/diagrams/gcp-architecture-diagram): Diagram your Google Cloud architecture — GKE, Cloud Run, Pub/Sub, Cloud SQL, and BigQuery — as an editable, presentable model. Build it with Architext — edit 
- [Cloudformation Diagram](https://architext.ai/diagrams/cloudformation-diagram): Turn an AWS CloudFormation template into an architecture diagram — resources, references, and dependencies — without hand-drawing. Build it with Architext — e
- [Pulumi Architecture Diagram](https://architext.ai/diagrams/pulumi-architecture-diagram): Visualize what your Pulumi program provisions as an editable architecture diagram you can document and present. Build it with Architext — edit on a canvas, do
- [Helm Chart Diagram](https://architext.ai/diagrams/helm-chart-diagram): Diagram what a Helm chart deploys — workloads, services, and their dependencies — as an editable Kubernetes architecture diagram. Build it with Architext — ed
- [Ecs Architecture Diagram](https://architext.ai/diagrams/ecs-architecture-diagram): Diagram your AWS ECS architecture — services, task definitions, load balancers, and datastores — as an editable model. Build it with Architext — edit on a can
- [Event-driven Architecture Diagram](https://architext.ai/diagrams/event-driven-architecture-diagram): Design an event-driven architecture diagram — producers, topics/queues, and consumers — with an AI co-editor. Build it with Architext — edit on a canvas, docu
- [Serverless Architecture Diagram](https://architext.ai/diagrams/serverless-architecture-diagram): Diagram a serverless architecture — functions, API gateways, queues, and managed datastores — and keep it editable. Build it with Architext — edit on a canvas
- [Three-tier Architecture Diagram](https://architext.ai/diagrams/three-tier-architecture-diagram): Draw a clean three-tier architecture diagram — presentation, application, and data tiers — in minutes. Build it with Architext — edit on a canvas, document, a
- [Data Pipeline Diagram](https://architext.ai/diagrams/data-pipeline-diagram): Diagram a data pipeline — sources, ingestion, processing, and sinks — as an editable architecture model. Build it with Architext — edit on a canvas, document,
- [Multi-tenant Saas Architecture Diagram](https://architext.ai/diagrams/multi-tenant-saas-architecture-diagram): Diagram a multi-tenant SaaS architecture — tenancy model, shared services, and data isolation — clearly enough to review. Build it with Architext — edit on a 
- [C4 Model Diagram](https://architext.ai/diagrams/c4-model-diagram): Build C4-style architecture diagrams — context, containers, and components — with drill-down between levels. Build it with Architext — edit on a canvas, docum
- [Sequence Diagram Generator](https://architext.ai/diagrams/sequence-diagram-generator): Generate a sequence diagram of how your services interact — requests, responses, and async messages — from your architecture. Build it with Architext — edit o
- [Network Architecture Diagram](https://architext.ai/diagrams/network-architecture-diagram): Diagram your network architecture — VPCs, subnets, gateways, and security boundaries — as an editable model. Build it with Architext — edit on a canvas, docum
- [Architecture Decision Record Template](https://architext.ai/diagrams/architecture-decision-record-template): Write architecture decision records (ADRs) that actually get read — context, options, decision, consequences — generated alongside the diagram they describe. 
- [Threat Model Template](https://architext.ai/diagrams/threat-model-template): Start a threat model from your actual architecture — assets, trust boundaries, STRIDE-style threats, and mitigations — instead of a blank page. Build it with 
- [Non-functional Requirements Examples](https://architext.ai/diagrams/non-functional-requirements): Make NFRs explicit and testable — performance, availability, security, recoverability, cost — attached to the architecture they constrain. Build it with Archi
- [System Context Diagram](https://architext.ai/diagrams/system-context-diagram): Draw the C4 system context diagram — your system, its users, and the external systems it touches — the one picture that aligns a room. Build it with Architext
- [Raid Log Template](https://architext.ai/diagrams/raid-log-template): Keep a living RAID log — risks, assumptions, issues, dependencies — generated with your architecture instead of rotting in a spreadsheet. Build it with Archit
- [Software Architecture Documentation](https://architext.ai/diagrams/software-architecture-documentation): Documentation that stays true to the system: generate diagrams, ADRs, NFRs, threat model, and cost notes from one model derived from your code and infrastruct

## Blog posts

- [What a solution architect actually delivers in the enterprise: a field guide for your first 90 days](https://architext.ai/blog/solution-architect-enterprise-deliverables-guide): You got the solution architect job. Now what do you actually produce? A practical guide to the deliverables that matter, how the role is really measured, and the traps that sink new architects.
- [How to create architecture diagrams from code (without hand-drawing)](https://architext.ai/blog/architecture-diagrams-from-code): Hand-drawn diagrams drift the moment you ship. Here's how to generate architecture diagrams straight from your code and infrastructure-as-code — and keep them in sync.
- [What goes in a solution architecture document (SAD)](https://architext.ai/blog/what-goes-in-a-solution-architecture-document): A practical checklist for a solution architecture document — context, decisions, NFRs, RAID, and threat model — and how to keep it consistent with the diagram.