Team Generator

Generate teams randomly based on rank. This is useful if you want to create lineups of balanced teams. See it in action here

Make sure to install the dependencies:

pnpm install

Setup

PostgreSQL is used for data storage. You can use Docker or a local PostgreSQL instance.

1. Copy .env.example to .env:

   cp .env.example .env

2. Update .env with your PostgreSQL connection string:

   DATABASE_URL="postgresql://user:password@localhost:5432/team_generator"
   

3. Install dependencies (this will also run Nuxt prepare and generate ZenStack schemas):

   pnpm install

   The postinstall script automatically runs nuxt:prepare and db:generate.

4. Run database migrations:

   pnpm db:migrate

   This uses zen migrate dev under the hood.

Development Server

Start the development server on http://localhost:3000

pnpm dev

Testing

The project uses Playwright for end-to-end testing with a separate test database.

Automated Test Suite

To run the full test suite (handles Docker container setup automatically):

pnpm test        # Run tests headlessly
pnpm test:ui     # Run tests with Playwright UI

Both commands automatically start the test database and preview server, then run tests.

Development Testing

For running tests against the dev server (with hot reload):

pnpm test:dev

This starts Docker and the dev server on port 3001 with the test database. Then in a separate terminal, run:

pnpm playwright test --ui

When done, stop the dev server (Ctrl+C) and run pnpm docker:down to stop the database.

Manual Test Commands

• pnpm test:server:dev - Start dev server with test database (requires Docker already running)
• pnpm test:server - Start preview server with test database (used by Playwright automatically)
• pnpm docker:up - Start test database container
• pnpm docker:down - Stop test database container