WordleX

A daily word game in English, Bahasa Indonesia, Sundanese and Javanese.

Start with CONTEXT.md for the vocabulary, docs/adr/ for the decisions, and docs/open-questions.md for what is deliberately still open.

Running it

pnpm install
docker compose up -d --wait
cp apps/api/.env.example apps/api/.env
#   fill in the two secrets and the Google OAuth client — apps/api/README.md says how
pnpm --filter @wordlex/api db:migrate
pnpm --filter @wordlex/api db:seed
pnpm dev

docker compose runs two Postgres containers on Supabase's image, so pg_cron is the same one production has (ADR 0019). db on 5432 is the one you develop against; db-test on 5433 is the one apps/api's tests migrate and truncate, and it keeps its data in a tmpfs so every run starts from an empty database.

• Landing page — http://localhost:3000
• Play — http://localhost:3001
• API — http://localhost:4000/health

pnpm build, pnpm check-types and pnpm test run across every package. pnpm lint and pnpm format are oxlint and oxfmt, which run over the whole repo in one pass rather than per package.

Git hooks are lefthook's, installed by pnpm install. Committing formats and lints the staged files; pushing builds whichever packages the outgoing commits touch and runs every test, which needs db-test to be up. Markdown is deliberately left unformatted, so the ADRs keep their hand-wrapped prose.

Layout

Path	What it is
apps/landing	Next.js, wordlex.afiefabd.com
apps/play	TanStack Start, play.wordlex.afiefabd.com
apps/api	Fastify, api.wordlex.afiefabd.com
packages/domain	The vocabulary, as types and functions
packages/ui	The design system and every component

Each has its own README. The shape and its one hard rule are in ADR 0015: the Dictionary and Answer Pool belong to apps/api and must stay there, because that is what keeps ADR 0003 true.