FlowDiagram
Software & system architectureMermaid

Hexagonal (ports & adapters) architecture template

How a service isolates domain logic from HTTP, messaging and databases through ports and adapters — useful when explaining clean architecture to a team. This architecture diagram template contains 15 labelled components.

Open in the editor →
  • Free — no account, no trial, no watermark
  • Fully editable shapes and connectors, not a screenshot
  • Export PNG, SVG or PDF, or share it as a link
  • Private: the diagram never leaves your browser

Components in this architecture diagram

  • REST controller adapter
  • Inbound port: PlaceOrder
  • CLI adapter
  • Message consumer adapter
  • Inbound port: CancelOrder
  • Application services
  • Domain model: Order, Money, Policy
  • Outbound port: OrderRepository
  • Outbound port: PaymentGateway
  • Outbound port: EventPublisher
  • Postgres repository adapter
  • In-memory repo for tests
  • Stripe adapter
  • Kafka publisher adapter
  • Postgres

How to use this architecture diagram template

  1. Click Open in the editor. The architecture diagram opens on a new page in FlowDiagram — nothing is uploaded and there is no sign-up.
  2. Rename, add or delete shapes and drag them where you want; connectors stay attached as things move.
  3. Drop in vendor logos from the library — 1,160 of them, including every AWS, Azure and Google Cloud service icon — or restyle it with the colour and theme controls.
  4. Prefer text? Edit the Mermaid source below and paste it in through ☰ → Import diagram (see the Mermaid editor); it imports as an editable diagram.
  5. Export to PNG, SVG or PDF, or press Ctrl+L for a link that carries the whole diagram.

Mermaid source

The whole template is the text below. Paste it into FlowDiagram, keep it in Git next to the code it describes, or hand it to an AI assistant to extend.

flowchart LR
  HTTP[REST controller adapter] --> IN1[Inbound port: PlaceOrder]
  CLI[CLI adapter] --> IN1
  MQ[Message consumer adapter] --> IN2[Inbound port: CancelOrder]
  IN1 --> APP[Application services]
  IN2 --> APP
  APP --> DOM[Domain model: Order, Money, Policy]
  APP --> OUT1[Outbound port: OrderRepository]
  APP --> OUT2[Outbound port: PaymentGateway]
  APP --> OUT3[Outbound port: EventPublisher]
  OUT1 --> PG[Postgres repository adapter]
  OUT1 --> MEM[In-memory repo for tests]
  OUT2 --> STRIPE[Stripe adapter]
  OUT3 --> KAFKA[Kafka publisher adapter]
  PG --> DB[(Postgres)]

Related: System architecture diagram tool · Mermaid editor · All software & system architecture templates · All 521 templates