Setup Dev Environment Skill

Use this skill when initializing or resetting the development environment.

When to Use

• First time setting up the project after cloning

• After pulling major changes that affect dependencies or database schema

• When the local environment is in a broken state and needs a fresh start

• When switching between branches with different dependency requirements

Prerequisites

• Docker and Docker Compose installed

• Go toolchain installed

• .env file configured (see README for required values)

Initialization Options

Option 1: Full Setup (with Node.js dependencies)

Use when you need to work with the tarkov.dev GraphQL schema or regenerate the client:

task init

This runs:

• deps:install:go

• Installs Go tools

• deps:install:node

• Installs Node.js tools

• migrate:up

• Applies all database migrations

Option 2: Go-Only Setup (recommended for most development)

Use for general development when you don't need to update external schemas:

task init:go-only

This runs:

• deps:install:go

• Installs Go tools (golangci-lint, goose, genqlient)

• migrate:up

• Applies all database migrations

What Gets Set Up

• Go Dependencies: Linter, migration tool, GraphQL client generator

• Docker Services: PostgreSQL database (and any other services in docker-compose.yml)

• Database Schema: All migrations applied to create tables and indexes

• Environment: Loads variables from .env file

Verification

After initialization, verify the setup:

Check Docker services are running

docker compose ps

Run unit tests (no database needed)

task test:unit

Run integration tests (uses database)

task test:integration

Troubleshooting

Database connection fails:

• Ensure .env has correct POSTGRES_* values

• Check if port 5432 is already in use: lsof -i :5432

• View logs: docker compose logs postgres

Migration errors:

• Check if previous migrations ran: docker compose exec postgres psql -U $POSTGRES_USER -d $POSTGRES_DB -c "\dt"

• Rollback and reapply: task migrate:down && task migrate:up

Go dependencies fail to install:

• Ensure Go is properly installed: go version

• Check GOPATH: go env GOPATH

• Manually install failing tool, e.g.: go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

Clean Reset

If you need to completely reset the environment:

Stop and remove all containers and volumes

task compose:down docker compose down -v

Clean build artifacts

task clean

Re-initialize

task init:go-only

Next Steps

After setup, you can:

• Start the API: task api:start

• Start the importer: task importer:start

• Start the evaluator: task evaluator:start

• Run tests: task test:unit or task test:integration