Pursuit

A self-hosted job application tracker for keeping roles, statuses, notes, and search metrics in one place.

---

Requirements

• Docker Desktop
• Node.js and npm for local typecheck/lint/build commands

Run Locally

git clone https://github.com/ansidian/pursuit.git
cd pursuit
docker compose up

This builds and starts the Docker Compose stack:

• Frontend: http://pursuit.localhost
• Frontend direct port: http://localhost:3000
• Backend API: http://localhost:4000
• Postgres: localhost:5432

Source files are mounted into the containers, so frontend and backend edits reload through the dev stack.

After Dockerfile or package changes, rebuild the containers:

docker compose up --build

Production-Style Build

docker compose -f docker-compose.prod.yml up --build

This builds and starts the production-style Docker Compose stack with nginx serving the frontend.

Open http://localhost:8080.

After frontend/source edits while using the production stack, rebuild the frontend container:

docker compose -f docker-compose.prod.yml up --build frontend

Local Checks

npm run typecheck
npm run lint
npm run build

Backend tests run through Docker:

docker compose run --rm backend npm run test --workspace backend

Database Reset

Development stack:

docker compose down -v
docker compose up --build

Production-style stack:

docker compose -f docker-compose.prod.yml down -v
docker compose -f docker-compose.prod.yml up --build

These commands delete the matching Docker volume and rebuild the stack.

---

Stop

docker compose down

For the production-style stack:

docker compose -f docker-compose.prod.yml down