GitPedia

Hexagony

Clean architecture example in Golang.

From cyruzin·Updated February 17, 2026·View on GitHub·
·Archived

Welcome to Hexagony Records! Hexagony name was taken from one of the Hate's songs. Hate is a death metal band from Poland. The project is written primarily in Go, distributed under the MIT License license, first published in 2019. Key topics include: clean-architecture, ddd-architecture, go, golang, hexagonal-architecture.

<p align="center"> <img src="https://github.com/williamscalado/hexagony/blob/master/logo_hexagony.png" width="300" title="Hexagony"> </p>

build Coverage Status Go Report Card GitHub license

Welcome to Hexagony Records! Hexagony name was taken from one of the Hate's songs. Hate is a death metal band from Poland.

Running

First rename the .env_example file to .env and fill the variables if you want.

Next, make sure you have Docker and Docker Compose installed and then run the following command:

sh
$ docker-compose up --build

Or in Detached Mode:

sh
$ docker-compose up -d --build

Then, check the app up and running: http://localhost:8000.

Documentation

Access: http://localhost:8000/docs/index.html

Generate doc:

sh
$ swag init -g ./cmd/server/main.go

Schema

Download the schema inside docs folder and import in your Insomnia application or another request tool.
You need to specify Authorization header along with the Bearer token.

Generate Token

Use the following credentials:

User: john@doe.com

Pass: 12345678

Front-End Application

Check the Hexagony front-end: https://github.com/williamscalado/hexagony-front-react

Contributors

Showing top 3 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from cyruzin/hexagony via the GitHub API.Last fetched: 6/23/2026