Variant Tid.

Getting started

You need Bun (the version in .bun-version) and Docker.

bun install
bun run dev

The app runs on http://localhost:3000.

Before pushing, run bun run check. It type-checks, lints and runs the tests.

Database

Postgres runs in Docker through Testcontainers, on whatever port is free. bun run dev starts it, applies new migrations, seeds a small fixture if it's empty, and stops it again when you quit. The container is kept between runs, so your data stays.

• bun run db:reset rebuilds the dev database from the fixture. The fixture's dates are relative to today.
• bun run db:studio opens Drizzle Studio against the dev database.

Tests get a fresh container each run, which is removed afterwards. Shutting down the dev server tears down database.

Troubleshooting

"Could not find a working container runtime strategy": Testcontainers can't find Docker. Check that Docker is running (docker info). If you use Colima, OrbStack or similar, Testcontainers doesn't read Docker contexts, so point it at the socket yourself, e.g. in your shell config:

export DOCKER_HOST=$(docker context inspect --format '{{.Endpoints.docker.Host}}')
export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock

Early life of Tid.

To check the app against real data, the dev database can be rebuilt from Harvest. See packages/harvest.