wiki / concepts / hexagonal-architecture

Hexagonal Architecture

updated 2026-08-25 principle · workflow

Hexagonal Architecture

Also known as “Ports and Adapters,” an architectural pattern created by alistair cockburn that isolates business logic from external systems through well-defined interfaces. This pattern directly influenced clean architecture and emphasizes the separation of core application logic from external concerns.

Core Concept

The hexagonal shape represents the application core surrounded by ports (interfaces) that connect to external adapters. Business logic remains independent of databases, user interfaces, and external services by communicating through ports rather than direct dependencies.

Relationship to Clean Architecture

robert c martin’s clean architecture synthesis incorporated hexagonal architecture principles, particularly:

  • Port-adapter separation — mirrors the interface adapter layer
  • Business logic isolation — core of the innermost entities layer
  • dependency rule compliance — dependencies point toward business logic

Adoption

The pattern was notably adopted by steve freeman and nat pryce in “Growing Object Oriented Software” and became a foundational element in the broader architectural synthesis that led to clean architecture.

[source: uncle-bob-clean-architecture-2012]

Evidence — verified primary sources
uncle-bob-clean-architecture-2012 https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html
ingested 2026-08-25
sha256:b99ae450b598…