go-service-bootstrapSafety --Repository ShareFavorite skill

When to Use

• Setting up main.go to wire all dependencies
• Adding environment-based configuration
• Managing secrets (DB passwords, API keys)
• Deciding what changes between local/dev/staging/prod
• Adding a new adapter/implementation swap
• Setting up docker-compose profiles

Critical Patterns

Environments

What Changes Per Environment

Logging

Database

The in-memory provider uses a pure Go map-based repository — zero external dependencies. See go-repository-pattern skill for implementation details.

Observability

Messaging

Object Storage

Security

Configuration

See assets/config.go — centralized config struct with typed helpers.

All configuration loaded once via config.Load(). Typed helpers: getEnv, requireEnv, getEnvInt, getEnvBool, getEnvDuration.

main.go — The Composition Root

See assets/main.go

The composition root follows a numbered sequence:

1. Load config
2. Setup logger
3. Infrastructure — databases
4. Infrastructure — messaging
5. Infrastructure — storage
6. Repositories (adapters)
7. Application services (use cases)
8. HTTP handlers
9. Router
10. Start server

Logger Setup

See assets/logger.go — environment-aware slog configuration (text for local, JSON for others).

Health Check Convention

Every service exposes two endpoints:

See assets/health_check.go

Graceful Shutdown

See assets/server.go — listens for context cancellation, 10-second shutdown timeout.

Environment Variable Files

api/{service}/
  .env.example        # Committed — all keys, safe defaults for local
  .env                 # NOT committed — developer's local overrides

See assets/env.example

NEVER commit .env — only .env.example.

Secrets (dev/staging/prod)

Secrets are NEVER in env files for non-local environments. Use:

Secrets are injected as environment variables at runtime by the orchestrator.

Docker-Compose Profiles

See assets/docker-compose.example.yml

# Start everything
docker-compose --profile local up -d

# Start only infra (DB, NATS, MinIO) — run services natively
docker-compose --profile infra up -d

# Start only observability stack
docker-compose --profile observability up -d

Assets

Commands

# Local dev with .env
cp .env.example .env
docker-compose --profile infra up -d
go run ./cmd/server

# Or use direnv
echo 'dotenv' > .envrc && direnv allow

# Run with specific env
APP_ENV=development go run ./cmd/server

# Verify environment
curl http://localhost:8080/health

Anti-Patterns