HexaGO (A simple ports & adapter architecture example)

What is HexaGO?

HexaGO is a simple example of a calculator app using the ports and adapter (hexagonal) architecture in Go. It demonstrates how to separate business logic (core) from external systems via ports and adapters.

How to use HexaGO?

Clone the repository, install air and templ, then run air in the project root. Open your browser and go to http://localhost:3000.

Key features of HexaGO

• Implements hexagonal architecture in Golang.
• Core business logic is isolated from external systems.
• Uses ports and adapters for clean separation.
• Includes calculator app example with HTTP and database adapters.
• Live reload via air tool for development.

Use cases of HexaGO

• Learning hexagonal architecture with a simple Go project.
• Refactoring existing Go apps to adopt ports and adapters pattern.
• Testing business logic independently of external dependencies.
• Demonstrating decoupled design to team members.

FAQ from HexaGO

What is HexaGO?

HexaGO is a small implementation of hexagonal architecture (ports and adapters) in Go, illustrating a calculator app.

How to run HexaGO?

Clone the repo, install air and templ, run air in the root, then open http://localhost:3000.

What dependencies are needed?

You need Go, air (go install github.com/cosmtrek/air@latest), and templ (go install github.com/a-h/templ/cmd/templ@