Modern Go starter using Fiber v2 and sqlx with a pragmatic developer workflow.

• Go 1.24
• Fiber v2 HTTP framework
• sqlx with PostgreSQL (lib/pq)
• Environment management via godotenv
• JWT utilities (github.com/golang-jwt/jwt/v5)
• Error tracking with Sentry (optional)
• Google Cloud Storage helper (optional)
• Live reload with Air (.air.toml, ./bin/air)
• Database migrations with golang-migrate
• Dockerfile for production builds
• Makefile with common tasks

.
├─ .air.toml
├─ .env.example
├─ Dockerfile
├─ Makefile
├─ public/
│  ├─ docs/
│  └─ email-template/
├─ script/
│  ├─ setup.sh
│  ├─ release.sh
│  └─ bump-version.sh
├─ src/
│  ├─ app/
│  │  └─ database/
│  │     └─ migrations/        # migration .sql files
│  ├─ config/
│  ├─ lib/
│  └─ main.go                   # application entrypoint
├─ bin/                         # local tools (air, migrate, etc.)
├─ go.mod
└─ go.sum

• Go 1.24+
• PostgreSQL database
• golang-migrate
  • Global: brew install golang-migrate (macOS), or see https://github.com/golang-migrate/migrate
  • Or adjust CMD_MIGRATE in Makefile to point to your local binary

1. Clone the repository
2. Copy environment file

   cp .env.example .env

3. Edit .env and set at least:
   • APP_NAME, APP_ENV, APP_PORT
   • DB_CONNECTION, DB_HOST, DB_PORT, DB_USERNAME, DB_PASSWORD, DB_DATABASE
4. Create your database in PostgreSQL
5. Run database migrations

   make db/migration/up

6. Start in development mode (hot-reload)

   make dev

   App runs on http://localhost:${APP_PORT}

• help: show available commands

  make help

• deps/update: upgrade deps and tidy

  make deps/update

• db/migration/create: create a new migration

  make db/migration/create
  # then enter a name, files appear in src/app/database/migrations

• db/migration/up / down: apply or rollback migrations

  make db/migration/up
  make db/migration/down

• build: produce a binary into ./cmd/${APP_NAME}

  make build

• start: build and run the binary

  make start

• setup, release, release/bump: utility scripts under script/
• tag/staging, tag/release: create version tags for deployments

• Local development reads .env (via godotenv).
• Migrations use DATABASE_URL derived from the DB_* variables in Makefile.
• Air config is in .air.toml and uses ./bin/air by default.

Build a minimal production image and run it:

docker build -t gofi:local .
docker run --env-file .env -p 8000:8000 gofi:local

Notes:

• The container exposes port 8000 by default.
• Ensure your env vars are suitable for the container environment (e.g., DB host is reachable from the container).

• This template doesn’t ship opinionated test/lint tools by default. Add your preferred stack (e.g., go test ./..., golangci-lint) as needed.

This project is licensed under the terms of the MIT License. See LICENSE.md.