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.
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
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.
