Event discovery and ticketing platform. Monorepo containing a NestJS API, React Router v7 web app, and a Kottster-based admin panel.

• Browse and filter events by format, tags, date range, location and free-text search
• Event creation with poster/gallery upload, scheduled publish date, attendee visibility controls, post-purchase redirect URL
• Ticket types per event with promo codes (flat discount %, org-wide or event-specific, max uses, active date range)
• Stripe Connect checkout with idempotent payment-intent handling and per-ticket issuance
• Organization accounts with wallet, payout withdrawal requests, revenue charts, and analytics dashboard
• Follow organizations and subscribe to event notifications (email + Web Push)
• TOTP two-factor authentication for both user and organization accounts
• Google OAuth sign-in for users
• Localized API responses via Accept-Language (en / ua)
• Kottster admin panel for managing users, organizations, events, tickets, tags, promo codes, and transactions

• Docker ≥ 24
• Docker Compose v2

cp apps/api/.env.example .env

Edit .env and fill in the required values (see Environment Variables).

docker compose up --build

Stripe webhooks: You must set STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET in .env. For Apple Pay / Google Pay domain registration run bash apps/api/scripts/register-stripe-domain.sh after the stack is up.

docker compose down          # keep DB data
docker compose down -v       # wipe DB volume too

• Node.js ≥ 18
• pnpm ≥ 10 (corepack enable or npm i -g pnpm)
• PostgreSQL ≥ 14 running locally (or start only the DB container: pnpm db:up)

pnpm install

# API
cp apps/api/.env.example apps/api/.env
# Edit apps/api/.env

# Web
cp apps/web/.env.example apps/web/.env
# Edit apps/web/.env

pnpm dev          # starts both api and web via Turborepo

Or individually:

pnpm --filter api dev
pnpm --filter web dev

pnpm --filter api seed:all

Either DATABASE_URL or the individual POSTGRES_* vars must be provided — not both.

uevent/
├── apps/
│   ├── api/          # NestJS backend — REST API, auth, payments, DB
│   │   └── src/
│   │       └── modules/
│   │           ├── auth/          # JWT, Google OAuth, TOTP 2FA (users + orgs)
│   │           ├── events/        # CRUD, filtering, subscriptions
│   │           ├── organizations/ # CRUD, follows, wallet, withdrawals
│   │           ├── tickets/       # Ticket types, issuance, private files
│   │           ├── payments/      # Stripe Connect, promo codes, transactions
│   │           ├── notifications/ # Email + Web Push dispatch
│   │           ├── tags/          # Event tags
│   │           ├── users/         # User profiles, sessions
│   │           └── files/         # File upload / storage
│   ├── web/          # React Router v7 SSR frontend (FSD architecture)
│   └── admin/        # Kottster admin panel
├── packages/         # Shared packages (reserved for future use)
├── docker-compose.yml
├── pnpm-workspace.yaml
└── turbo.json

• Set DB_SYNCHRONIZE=false — the API will refuse to start in NODE_ENV=production if this is true. Use a proper migration strategy for schema changes.
• JWT_SECRET must be at least 64 characters — the API rejects shorter values on startup.
• All secrets (JWT_SECRET, STRIPE_*, SMTP_*, VAPID_*) must be set before starting the stack. The API validates all required env vars on startup and exits with a descriptive error if any are missing.
• The GOOGLE_CALLBACK_URL must point to the publicly reachable API URL if Google OAuth is enabled.
• STRIPE_WEBHOOK_SECRET is required in production whenever STRIPE_SECRET_KEY is set.