microservices-go
Golang Microservice Boilerplate using PSQL, Docker and Cucumber, API REST. Gin Go and GORM with pagination and implementation of a Clean Architecture.
godockerpaginationgolangboilerplatejwtrest-apiclean-architecturecucumbergingormmicroservices-architecture
FreeRepo
Preview
Overview
This is a production-ready Go microservices boilerplate implementing Clean Architecture with REST APIs, JWT authentication, PostgreSQL and comprehensive testing. Built with Gin-Gonic, structured logging via Zap and Docker containerization, it helps teams ship fast with organized layers for domain logic, application use cases and infrastructure concerns, complete with unit and integration tests, security features and full API documentation.
Features
clean-architecturejwt-authenticationstructured-loggingcomprehensive-testingapi-documentationerror-handlingrequest-validationsearch-and-paginationcors-configurationpassword-hashinghealth-checksdependency-injectionhexagonal-architecture
Feature Flags
authenticationblogemailspaymentsauthorizationloggingErrorTrackingsearchnotificationsapiDocsformsValidation
Recommended Use Cases
microservices-developmentrest-api-backendproduction-ready-applicationsclean-architecture-learninggolang-projects
Frontend
None
Backend
gogingormpostgresqlzap
Auth Providers
jwt
Deployment Targets
docker
Payment Providers
None
Quick Facts
⭐ Stars
661
🍴 Forks
80
🧾 License
mit
🔄 Active
Unknown
🕒 Last Commit
2025-07-02T23:05:33.000Z
GitHub
Stack
Framework
gin
Language
go
Database
postgresql
ORM
gorm
Testing
go-testing, cucumber
Logging
zap
Data Layer
Databases
postgresql
ORM
gorm
UI Stack
Developer Experience
Docker
Yes
Tests
Yes
Quickstart
Yes
env.example
Yes
Pricing
Classification
free
Selected
—
Notes
Open source project under MIT license