GoServerTemplate

GoServerTemplate

Production-ready Go server template with layered architecture, dependency injection, and PostgreSQL support.

Architecture

cmd/server         → Application entrypoint (FX bootstrap)
internal/config    → Environment-based configuration
internal/db        → PostgreSQL connection (sqlx + pgx)
internal/handler   → HTTP handlers (handler → service → repo)
internal/service   → Business logic
internal/repository → Data access layer
internal/router    → gorilla/mux routing + middleware
pkg/logger         → Structured logging (slog)

Dependencies

• gorilla/mux — HTTP router
• uber-go/fx — Dependency injection & lifecycle
• jmoiron/sqlx + pgx — PostgreSQL

Environment Variables

Running Locally

# Run server
go run ./cmd/server

# Run tests
go test ./...

# Build binary
go build -o server ./cmd/server
./server

Docker

docker build -t go-server-template .
docker run -p 8080:8080 -e PORT=:8080 go-server-template

Routes