Architecture (@arch)

Architecture diagrams are the most common TDL diagram type. They show system components and their relationships.

@arch
[nodes]
  web:Web Frontend|cloud
  api:API Gateway
  auth:Auth Service|cyl
  db:PostgreSQL|cyl

[edges]
  web->api:REST
  api->auth:validate
  api->db:query

Rendered diagram

When to Use

• System architecture overviews

• Microservices communication

• Cloud infrastructure diagrams

• Data flow between components

Key Concepts

Concept	Description	Example
Nodes	Components in your system	api:API Gateway
Shapes	Visual representation	|cyl for databases
Edges	Connections between nodes	api->db:query
Groups	Logical groupings	[Backend] section
Icons	Cloud provider logos	|icon:aws-lambda

Quick Reference

@arch

[nodes]
  # Basic node
  api:API Gateway

  # Node with shape
  db:Database|cyl

  # Node with icon
  lambda:Handler|icon:aws-lambda

  # Node with color
  error:Error Handler|color:red

[edges]
  # Solid arrow (sync)
  api->db:query

  # Dashed arrow (async)
  api-->queue:publish

  # Bidirectional
  a<->b:sync

[groups]
  [VPC]
    api
    db

Rendered diagram

In This Section

• Basic Components - Nodes and labels

• Shapes - All 12 available shapes

• Connections - Edge types and styling

• Groups - Organizing components

• Styling - Colors and named styles

• Icons - Cloud provider icons

• Real-World Examples - Production-ready patterns