# iso-topology

> Turn text into isometric architecture diagrams. Learn the CLI, Studio, YAML and D2, Go library, and MCP tools.

- [Architecture, with another dimension.](https://iso-topology.mintlify.app/index.md): Build isometric architecture diagrams from text. Refine them in Studio. Keep the source alongside your code.
- [Your first diagram](https://iso-topology.mintlify.app/quickstart.md): Install iso-topology, render a D2 diagram, and open the same source in Studio.
- [Made with iso-topology](https://iso-topology.mintlify.app/gallery.md): Real diagrams, with source files you can use as starting points.
- [Installation](https://iso-topology.mintlify.app/getting-started/01-install.md): Install the CLI, build from source, or add the Go library to your project.
- [Your first scene](https://iso-topology.mintlify.app/getting-started/02-first-scene.md): Render a small service architecture from D2 and inspect its output.
- [Groups and boundaries](https://iso-topology.mintlify.app/getting-started/03-grouping.md): Organize services into nested containers in D2 and YAML.
- [Replicas and annotations](https://iso-topology.mintlify.app/getting-started/04-replicas-annotations.md): Add stacked replicas, explanatory callouts, and an isometric grid.
- [Publish a diagram](https://iso-topology.mintlify.app/getting-started/05-publishing.md): Embed SVG in documentation and export images for presentations.
- [Studio](https://iso-topology.mintlify.app/guides/studio.md): Edit diagrams in a local browser workbench with live source and canvas interactions.
- [Design a scene](https://iso-topology.mintlify.app/guides/scene-design.md): Choose layouts, hierarchy, colors, and connector styles for readable architectures.
- [Troubleshooting](https://iso-topology.mintlify.app/guides/troubleshooting.md): Resolve installation, rendering, validation, and output-quality issues.
- [Extend the renderer](https://iso-topology.mintlify.app/guides/extending.md): Add shapes, DSL primitives, layout engines, and editing controls.
- [Why isometric?](https://iso-topology.mintlify.app/concepts/why-isometric.md): The design choices behind isometric architecture diagrams.
- [CLI reference](https://iso-topology.mintlify.app/reference/cli.md): Commands, flags, output files, and exit codes for isotopo.
- [Go library and APIs](https://iso-topology.mintlify.app/reference/api.md): Parse, render, validate, and edit diagrams through the programmable interfaces.
- [Output files](https://iso-topology.mintlify.app/reference/output-layout.md): Understand topology files, per-node assets, and export formats.
- [YAML and JSON](https://iso-topology.mintlify.app/reference/dsl-yaml.md): The composition language for shapes, groups, placement, and connections.
- [D2](https://iso-topology.mintlify.app/reference/dsl-d2.md): Use D2 graph syntax with automatic layout and isometric rendering.
- [Styles and themes](https://iso-topology.mintlify.app/reference/dsl-theme.md): Configure colors, strokes, typography, effects, and reusable presets.
- [Shapes and geometry](https://iso-topology.mintlify.app/reference/shapes-geometry.md): Geometry parameters, shapes, and the relationship between dimensions and projection.
- [Built-in icons](https://iso-topology.mintlify.app/agent/ICONS.md): Browse the built-in glyphs, brand logos, and their icon URIs.
- [Agent onboarding](https://iso-topology.mintlify.app/getting-started/00-onboarding.md): Give a coding agent the installation steps, capabilities, and workflow for drawing diagrams.
- [MCP server](https://iso-topology.mintlify.app/agent/MCP.md): Connect a tool-using agent to the local diagram engine over stdio.
- [Prompt template](https://iso-topology.mintlify.app/agent/PROMPT_TEMPLATE.md): A reusable prompt with a generated capability contract for diagram-authoring agents.
- [Capabilities](https://iso-topology.mintlify.app/agent/CAPABILITIES.md): The generated contract for supported inputs, shapes, primitives, and styles.
- [Recipes](https://iso-topology.mintlify.app/agent/RECIPES.md): Map common architecture-diagram tasks to supported DSL primitives.
- [Sample sources](https://iso-topology.mintlify.app/agent/SAMPLES.md): Find example scenes and individual shapes in the golden-tested fixture collection.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.