flip-x is an unofficial fan-made spinoff of press-your-luck card games. It is not affiliated with, endorsed by, or sponsored by any card-game publisher. Names and mechanics are used for homage and gameplay only.
flip-x is a shared-table web app with live turn tracking, action-card resolution, and automatic scoring to 200 points.
- Next.js 16
- Tailwind CSS v4, shadcn/ui
- Convex + Confect
- Effect-TS at service boundaries
- Vitest, Playwright, GitHub Actions
See AGENTS.md for architecture and development workflow.
mise install # installs the pinned hk version and Git hooks
pnpm install
npx convex dev # separate terminal
pnpm dev # https://flip-x.localhost via portlessUse PORTLESS=0 pnpm dev for plain http://localhost:3000.
The hk pre-commit hook formats staged files and runs the fast lint, i18n, and
React Doctor checks. Pre-push adds the broader lint, Fallow, test, and design gates.
Run either hook directly with mise run pre-commit or mise run pre-push. If hk
is installed globally, mise install reuses that setup instead of installing a
duplicate repository hook. See docs/git-hooks.md for setup,
behavior, and migration details.
See docs/testing.md. Quick commands:
pnpm test # engine, infra, contract, ui, confect
pnpm test:backend # Convex smoke (local deployment by default)
pnpm test:e2e # Playwright
pnpm ci:local # pre-PR checkConfigure in your Convex and Vercel dashboards:
- Vercel:
NEXT_PUBLIC_CONVEX_URL(production Convex deployment URL) - Convex:
POSTHOG_PROJECT_TOKENand other backend env vars vianpx convex env set - PostHog (optional):
NEXT_PUBLIC_POSTHOG_KEY,NEXT_PUBLIC_POSTHOG_HOST, build-time source map vars
MIT — see LICENSE.