Go Web Development Stack

Go Web Development Stack

A production-shaped Go development environment that starts on the first docker compose up. Air watches your source and hot-reloads the binary on every save. Postgres, Redis, and Adminer are pre-wired so you can start writing handlers immediately.

What's Included

• Go 1.27 with Air live-reload — binary restarts on every .go file change
• Postgres 16 with a health-check dependency so the app waits for DB readiness
• Redis 7 for caching and session state
• Adminer for visual DB management
• Makefile with common tasks: make run, make build, make migrate, make psql

Developer Experience

• Air config (.air.toml) pre-tuned for Go web services — excludes vendor/ and test files
• Go module cache in a named volume — go mod download runs once, not on every restart
• DATABASE_URL and REDIS_URL injected as environment variables, ready for pgx or database/sql
• Package layout follows standard Go project conventions (cmd/, internal/)

What You Get

• docker-compose.yml — all four services
• Dockerfile — dev stage (Air) and release stage (minimal scratch image)
• cmd/server/main.go — HTTP server starter with DB and Redis connection checks
• Makefile — common dev tasks
• .air.toml, .env.example, .gitignore, README.md

Service URLs

• App: http://localhost:8080
• Adminer: http://localhost:8081
• Postgres: localhost:5432
• Redis: localhost:6379