Repertoire Hero

This is a Next.js project bootstrapped with create-next-app.

Local development

Step one for everyone, runner or not — Docker Compose reads .env in every subcommand, so the file has to exist:

cp .env.example .env
cp .env.example .env.local   # the host-side tooling (migrations, vitest) reads this one

Standalone — the repo starts its own PostgreSQL and the app container next to it. The bundled database publishes ${POSTGRES_PORT:-54322}; override the port inline when 54322 is already taken on your machine:

COMPOSE_PROFILES=standalone POSTGRES_PORT=54323 docker compose up -d --wait
curl -o /dev/null -w '%{http_code}\n' http://localhost:3000/   # 200

Shared Postgres via poli-runner — the bundled database stays down and the app points at the shared cluster's repertoire_hero database instead (wired from poli-runner.yml):

poli-runner start repertoire_hero

Seed a local database with dev users and the shared song catalogue (scripts/seed-catalog.sql); it targets DATABASE_URL, or takes the connection string as an argument:

npm run seed

Run the tests. The database-backed suites are opt-in behind RUN_DB_TESTS, and they need a live, migrated PostgreSQL at DATABASE_URL; without it they skip and vitest prints a warning saying so:

npx vitest run                 # unit suites only — DB-backed files skip
RUN_DB_TESTS=1 npx vitest run  # the full suite

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.