Go Hexagonal Architecture

What problem does it solve?

It provides an opinionated blueprint for building Go services using a hexagonal (ports-and-adapters) architecture, helping teams create maintainable, testable, and evolvable codebases by strictly separating domain logic from infrastructure.

Core Features & Use Cases

• Opinionated project layout for Go services (cmd/, internal/, storage/adapters) with clear separation of domain, service, and infrastructure.
• Demonstrates translation between domain models and persistence, plus zero-dependency domain entities to enable pure logic testing.
• Use cases include building new services, refactoring monoliths, and teaching teams a scalable architecture pattern.

Quick Start

Create a new Go service and structure it using a ports-and-adapters layout with clear domain, service, and storage boundaries.