eventza

An event ticketing platform. Organizers can create and sell tickets, attendees can browse and purchase them, and staff can check people in at the door with a QR scanner.

What's in here

Three apps in a monorepo:

• apps/api — REST API (Express + PostgreSQL)
• apps/web — main web app (Next.js)
• apps/scanner — QR check-in app for event staff (Next.js)
• packages/shared — shared TypeScript types

Features

• Email/password auth + passwordless login via OTP email
• JWT access tokens with refresh token rotation
• Create events with categories, location, images (stored on S3)
• Buy tickets — Stripe handles payments (payment intents + webhooks)
• QR codes generated per order for check-in
• Staff log into the scanner app and scan QR codes to mark attendees as checked in
• Organizer dashboard with charts (sales, attendance)
• Dark mode

Stack

Layer	Tech
API	Express 5, TypeScript, Sequelize, PostgreSQL
Auth	Argon2, JWT, OTP via Resend
Payments	Stripe
Storage	AWS S3 (via multer)
Validation	Zod
Web / Scanner	Next.js 16 (App Router), React 19, Tailwind CSS 4
Data fetching	TanStack Query
Forms	React Hook Form + Zod
Monorepo	Turborepo + pnpm workspaces

Setup

Prerequisites

• Node.js 20+
• pnpm (npm i -g pnpm)
• PostgreSQL database
• Stripe account
• AWS S3 bucket
• SMTP credentials (for sending OTP emails)

Install

pnpm install

Environment variables

apps/api/.env

PORT=3001

DB_HOST=
DB_PORT=5432
DB_NAME=
DB_USER=
DB_PASSWORD=

JWT_SECRET=
JWT_REFRESH_SECRET=

SMTP_HOST=
SMTP_PORT=
SMTP_USER=
SMTP_PASS=
EMAIL_FROM=

AWS_REGION=
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
S3_BUCKET_NAME=

STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=

apps/web/.env.local

NEXT_PUBLIC_API_URL=http://localhost:3001
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=

apps/scanner/.env.local

NEXT_PUBLIC_API_URL=http://localhost:3001

Database

Run migrations from the apps/api directory:

cd apps/api
pnpm migrate

Dev

From the root — starts all three apps in parallel:

pnpm dev

Or run them individually:

pnpm dev:api   # API on :3001
pnpm dev:web   # Web on :3000

The scanner app runs on :3002 when started directly from apps/scanner.

Build

pnpm build