IoT Architecture Diagram Generator

Quick Start: Select device/sensor icons → Place edge gateways → Connect to cloud services → Group into zones → Wrap in ```plantuml fence.

⚠️ IMPORTANT: Always use ```plantuml or ```puml code fence. NEVER use ```text — it will NOT render as a diagram.

Critical Rules

Every diagram starts with @startuml and ends with @enduml
Use left to right direction for typical IoT data flows (Device → Edge → Cloud)
Use mxgraph.aws4.* stencil syntax for IoT service and device icons
Default colors are applied automatically — you do NOT need to specify fillColor or strokeColor
Use rectangle "Zone" { ... } or package "Site" { ... } for grouping
Directed flows use -->, async/event-driven flows use ..> (dashed)

Full stencil reference: See stencils/README.md for 9500+ available icons.

Mxgraph Stencil Syntax

mxgraph.aws4.<icon> "Label" as <alias>

Core IoT Stencils

Category	Stencils	Purpose
IoT Platform	`iot_core`, `internet_of_things`, `iot_1click`	Central IoT hub / message broker
Edge/Gateway	`greengrass`, `iot_device_gateway`, `freertos`, `iot_expresslink`	Edge computing & device gateway
Greengrass	`iot_greengrass_component`, `iot_greengrass_nucleus`, `iot_greengrass_stream_manager`	Edge runtime components
Device Mgmt	`iot_device_management`, `iot_device_defender`, `iot_device_tester`, `iot_over_the_air_update`	Fleet provisioning, security, OTA
Analytics	`iot_analytics`, `iot_analytics_channel`, `iot_analytics_pipeline`, `iot_analytics_dataset`, `iot_analytics_data_store`	IoT data processing pipeline
Events/Rules	`iot_events`, `iot_device_defender_iot_device_jobs`	Event detection & job execution
Digital Twin	`iot_twinmaker`, `iot_sitewise`, `iot_sitewise_asset`, `iot_sitewise_asset_model`	Asset modeling & visualization
Fleet	`iot_fleetwise`, `iot_device_management_fleet`	Vehicle & device fleet telemetry

Device & Sensor Stencils

Category	Stencils
Sensors	`sensor`, `iot_thing_temperature_sensor`, `iot_thing_humidity_sensor`, `iot_thing_vibration_sensor`, `iot_thing_temperature_humidity_sensor`, `iot_thing_temperature_vibration_sensor`
Actuators	`actuator`, `iot_thing_relay`, `iot_thing_stacklight`
Industrial	`factory`, `iot_thing_industrial_pc`, `iot_thing_plc`
Smart Home	`thermostat`, `alexa_enabled_device`, `alexa_smart_home_skill`, `camera`, `camera2`
Protocols	`mqtt_protocol`, `iot_lorawan_protocol`, `iot_greengrass_protocol`
Boats/Vehicles	`iot_sailboat`, `iot_fleetwise`
Robotics	`robomaker`, `iot_roborunner`

Connection Types

Syntax	Meaning	Use Case
`A --> B`	Solid arrow	Sync API / data flow
`A ..> B`	Dashed arrow	Async telemetry / MQTT publish
`A -- B`	Solid line	Physical / bidirectional link
`A --> B : "label"`	Labeled connection	Describe protocol or data

Quick Example

@startuml
left to right direction
rectangle "Factory Floor" {
  mxgraph.aws4.sensor "Temp\nSensor" as s1
  mxgraph.aws4.iot_thing_plc "PLC" as plc
}
mxgraph.aws4.greengrass "Greengrass\nEdge" as gg
mxgraph.aws4.iot_core "IoT Core" as core
mxgraph.aws4.iot_analytics "IoT\nAnalytics" as analytics

s1 --> gg : MQTT
plc --> gg
gg --> core
core --> analytics
@enduml

IoT Architecture Types

Type	Purpose	Key Stencils	Example
Smart Factory	Industrial IoT monitoring	`sensor`, `iot_thing_plc`, `greengrass`, `iot_sitewise`	smart-factory.md
Smart Home	Home automation	`thermostat`, `alexa_enabled_device`, `camera`, `iot_core`	smart-home.md
Fleet Telemetry	Vehicle fleet tracking	`iot_fleetwise`, `iot_core`, `iot_analytics`	fleet-telemetry.md
Edge Computing	Local processing at edge	`greengrass`, `freertos`, `iot_greengrass_component`	edge-computing.md
Digital Twin	Asset modeling & simulation	`iot_twinmaker`, `iot_sitewise_asset_model`, `iot_sitewise`	digital-twin.md
Sensor Network	Distributed sensor mesh	`sensor`, `iot_lorawan_protocol`, `iot_device_gateway`	sensor-network.md
Device Management	Fleet provisioning & OTA	`iot_device_management`, `iot_device_defender`, `iot_over_the_air_update`	device-management.md
Robotics	Robot fleet orchestration	`robomaker`, `iot_roborunner`, `greengrass`	robotics.md