All Shapes

Visual reference for all TDL node shapes.

Shape Syntax

id:Label|shape

Shape Catalog

rect (default)

Standard rectangle. The default shape if none specified.

node:My Service|rect
node:My Service        # Same as above

---

cyl (cylinder)

Cylinder shape representing data storage.

db:PostgreSQL|cyl
cache:Redis|cyl
queue:RabbitMQ|cyl

---

cloud

Cloud-like shape for external or user-facing components.

users:End Users|cloud
web:Web App|cloud
external:Third Party|cloud

---

diamond

Diamond shape for decision points and routing.

lb:Load Balancer|diamond
router:Router|diamond
decision:Check Valid?|diamond

---

oval

Rounded oval shape.

actor:User|oval
process:Background Job|oval

---

hex (hexagon)

Hexagonal shape.

port:HTTP Port|hex
adapter:DB Adapter|hex

---

doc (document)

Document/page shape.

config:config.yaml|doc
readme:README.md|doc
schema:schema.json|doc

---

grp (group)

Visual grouping boundary.

vpc:VPC|grp
cluster:Cluster|grp

---

terminator

Rounded rectangle (stadium shape).

start:Start|terminator
end:End|terminator

---

data

Parallelogram shape.

input:User Input|data
output:Report Output|data

---

subproc (subprocess)

Rectangle with double vertical lines.

batch:Batch Process|subproc
external:External System|subproc

---

manual

Trapezoid shape.

review:Manual Review|manual
approval:Approval Step|manual

---

connector

Small circle for junction points.

junction:A|connector
merge:B|connector

---

Quick Reference Table

Shape	Syntax	Common Use
Rectangle	|rect	Services, APIs
Cylinder	|cyl	Databases, caches
Cloud	|cloud	External, users
Diamond	|diamond	Decisions, routing
Oval	|oval	Actors, processes
Hexagon	|hex	Adapters, ports
Document	|doc	Files, configs
Group	|grp	Boundaries
Terminator	|terminator	Start/End
Data	|data	I/O
Subprocess	|subproc	External process
Manual	|manual	Human action
Connector	|connector	Junction points

Combining with Other Properties

Shapes can be combined with colors and icons:

[nodes]
  db:Database|cyl|color:blue
  cache:Cache|cyl|icon:aws-amazon-elasticache
  error:Error Handler|rect|color:red