setup-dev-environment

To set up a local development environment with Go, Docker, and PostgreSQL, you need running Docker Compose, the Go toolchain, and a configured .env file. The setup task automates initializing database migrations and bringing services online.

The best way to automate database migrations and dependency setup is running an automated setup task. It leverages repository scripts to apply migrations and configure tooling, ensuring a consistent starting point without manual configuration.

Docker Compose is required for full setups involving PostgreSQL and external services. However, you can perform a Go-only setup that skips Docker services when external schemas or Node.js dependencies are not required.

Yes, you can reset your local development environment after switching branches. The setup task handles both initialization and recovery, reapplying database migrations and tooling configurations to restore a healthy state.

To verify your Docker and Go development environment is healthy, the setup task includes built-in verification and troubleshooting guidance. This validates that services are online and database migrations have applied correctly.

Your local development environment setup fails when Docker services cannot start if prerequisites are missing. You must have Docker running, Docker Compose installed, the Go toolchain configured, and a valid .env file before execution.