perauset-e2e-mrfzphpz/CLAUDE.md

Perauset

Village operations platform.

Project Structure

• backend/ — Backend server (uWebSockets + Pikku)
• packages/functions/ — Shared business logic / Pikku functions
• sql/ — Database migrations (postgres-migrations)

Running

Backend

cd backend && yarn dev

Runs tsx watch with env files (../.env and .env.local). Watches for changes and auto-restarts.

Port

Service	Port
Backend	6002

Commands

• yarn pikku — Run Pikku CLI codegen (pikku all)
• yarn pikku:watch — Run Pikku CLI codegen in watch mode
• yarn prebuild — Bootstrap + codegen
• yarn tsc — Type-check all workspaces
• cd backend && yarn dbmigrate — Run database migrations
• cd packages/functions && yarn db:types — Regenerate Kysely DB types

Package Manager

Uses Yarn 4.9.2 (with workspaces). Node >= 22 required.

Database

PostgreSQL, database name perauset, default schema app.