Model your systems.
Ship with confidence.
Define architecture in YAML, write documentation in MDX, and validate your systems against the model — all from a single source of truth.
Trusted by engineering teams worldwide
Everything you need to design, document, and validate
A complete platform for software architects, analysts, and developers to model information systems and maintain project documentation.
Architecture Diagrams
Create component, sequence, deployment, and network diagrams from YAML source code. Visual editor included.
MDX Documentation
Write rich project documentation in MDX format with visual and source code editing modes.
Architecture as Code
Define your entire architecture model in YAML. Version control with Git. Review changes in PRs.
Documentation as Code
MDX documentation lives alongside your code. CI/CD friendly. Always up to date.
VS Code Integration
Edit diagrams and documentation directly in your IDE with the IOModel VS Code plugin.
Model Validation
Scan your live systems and compare against the documented architecture model to detect drift.
Visual & Code Editor
Toggle between WYSIWYG visual editor and raw source code for both diagrams and documentation.
Multi-level Views
Drill down from system context to component-level detail. Different views for different audiences.
From code to validated architecture in three steps
system: name: Payment Service type: microservice tech: Go, gRPC owner: payments-team
Define
Write architecture in YAML and documentation in MDX — in your IDE or in the browser.
┌─────────────┐ ┌─────────────┐
│ Web App │────▶│ API Gateway │
└─────────────┘ └──────┬──────┘
│
┌──────▼──────┐
│ Payment │
│ Service │
└─────────────┘Visualize
See live diagrams and rendered documentation instantly. Navigate multi-level views.
✓ Payment Service: model matches deployment ✓ API Gateway: endpoints verified ⚠ Auth Service: 2 undocumented endpoints ✗ Cache Layer: not found in production
Validate
Scan your running systems. Compare reality against the model. Detect architectural drift.
Define architecture. See it live.
Write YAML on the left. See the rendered diagram on the right. Every change is instant.
system:
name: E-Commerce Platform
components:
- name: Web Application
type: frontend
tech: React, Next.js
description: Customer-facing web interface
- name: API Gateway
type: service
tech: Node.js, Express
description: Central API routing and auth
- name: Product Service
type: service
tech: Go
description: Product catalog management
- name: Order Service
type: service
tech: Java, Spring Boot
- name: PostgreSQL
type: database
tech: PostgreSQL 16
connections:
- from: Web Application
to: API Gateway
protocol: HTTPS
- from: API Gateway
to: Product Service
protocol: gRPC
- from: API Gateway
to: Order Service
protocol: gRPC
- from: Order Service
to: PostgreSQL
protocol: TCP/5432system:
name: E-Commerce Platform
components:
- name: Web Application
type: frontend
tech: React, Next.js
description: Customer-facing web interface
- name: API Gateway
type: service
tech: Node.js, Express
description: Central API routing and auth
- name: Product Service
type: service
tech: Go
description: Product catalog management
- name: Order Service
type: service
tech: Java, Spring Boot
- name: PostgreSQL
type: database
tech: PostgreSQL 16
connections:
- from: Web Application
to: API Gateway
protocol: HTTPS
- from: API Gateway
to: Product Service
protocol: gRPC
- from: API Gateway
to: Order Service
protocol: gRPC
- from: Order Service
to: PostgreSQL
protocol: TCP/5432Component diagram renders here
Interactive preview from YAML source
Documentation that stays current.
MDX documentation with a visual editor. Switch between code and WYSIWYG modes seamlessly.
---
title: Payment Service API
version: 2.1.0
owner: payments-team
---
# Payment Service
The Payment Service handles all payment processing
for the e-commerce platform.
## Architecture
This service communicates with:
- **Order Service** via gRPC
- **Stripe API** for payment processing
- **PostgreSQL** for transaction records
## Endpoints
### POST /api/payments/process
Processes a new payment transaction.
```json
{
"orderId": "ord_123",
"amount": 99.99,
"currency": "USD",
"method": "card"
}
```
### GET /api/payments/:id
Returns payment status and details.
## Deployment
Deployed as a container on **EKS**
with 3 replicas minimum.---
title: Payment Service API
version: 2.1.0
owner: payments-team
---
# Payment Service
The Payment Service handles all payment processing
for the e-commerce platform.
## Architecture
This service communicates with:
- **Order Service** via gRPC
- **Stripe API** for payment processing
- **PostgreSQL** for transaction records
## Endpoints
### POST /api/payments/process
Processes a new payment transaction.
```json
{
"orderId": "ord_123",
"amount": 99.99,
"currency": "USD",
"method": "card"
}
```
### GET /api/payments/:id
Returns payment status and details.
## Deployment
Deployed as a container on **EKS**
with 3 replicas minimum.# Payment Service The Payment Service handles all payment processing for the e-commerce platform. ## Architecture This service communicates with: • Order Service via gRPC • Stripe API for payment processing • PostgreSQL for transaction records ## Endpoints ▸ POST /api/payments/process Processes a new payment transaction. ▸ GET /api/payments/:id Returns payment status and details. ## Deployment Deployed as a container on EKS with 3 replicas minimum.
Built for every role in your team
Architects
Model system architecture at any scale. Validate that implementation matches design. Keep diagrams as the single source of truth.
Analysts
Write and maintain project documentation in MDX. Visual editor for non-technical stakeholders. Always in sync with architecture.
Developers
Edit architecture and docs from VS Code. Architecture as Code fits your Git workflow. Review changes in pull requests.
What our users are saying
“IOModel completely changed how we manage our architecture documentation. The YAML-based approach fits perfectly into our Git workflow.”
Alex Chen
Principal Architect, TechCorp
“The model validation feature saved us from deploying breaking changes multiple times. It's like having a guardian for your architecture.”
Maria Santos
Engineering Manager, CloudScale
“Finally, documentation that developers actually maintain. The VS Code plugin makes editing architecture docs as natural as writing code.”
James Wilson
Senior Developer, DevFlow
“We consolidated 50+ scattered diagrams into a single IOModel workspace. Now everyone has access to the same source of truth.”
Sarah Kim
Solutions Architect, DataSphere
“The dual editor mode is brilliant — our analysts use the visual editor while developers work in code. Same output, different workflows.”
David Müller
CTO, InnoSoft
“Architecture as Code was exactly what we needed. PR reviews for architecture changes brought a new level of governance to our team.”
Priya Patel
Lead Architect, FinServ
Transparent pricing
Start free, upgrade when you need more.
Free
For individuals and small projects getting started.
- Up to 5 diagrams
- Up to 3 documents
- VS Code plugin
- Community support
- Single user
Pro
For professionals who need full power and flexibility.
- Unlimited diagrams
- Unlimited documents
- Model validation
- Priority support
- API access
- Custom themes
Team
For teams collaborating on complex systems.
- Everything in Pro
- Team collaboration
- Shared workspaces
- Role-based access
- Version history
- Audit logs
Enterprise
For organizations with advanced security and scale needs.
- Everything in Team
- SSO / SAML
- Custom SLA
- Dedicated support
- On-premise option
- Custom integrations