TypeScript 97.6%
SQL 1.4%
JavaScript 0.5%
1# Spinza23**www.spinza.dev — The Virtual Casino Playground.**45Spinza is a premium *fictional* social casino: twenty original games, a real server-authoritative game engine, cryptographically secure RNG, versioned game mathematics, a simulation & certification platform and an immutable wallet ledger — all running on **Spinza Credits (SC)**, a virtual currency with no monetary value.67> Virtual credits only. No deposits. No withdrawals. No cash value. 18+.89## What's inside1011- `packages/game-core` — the Spinza Game Engine (ways/lines, wilds, scatters, cascades, hold & respin, pick bonuses, persistent meters, heat, mystery, quantum split, dynamic grids, fictional jackpots), simulator and certification.12- `games/` — 20 original definitions (`defineGame`), calibration and 10,000,000-spin certification reports.13- `apps/api` — Fastify API: username/password accounts (Argon2id), recovery codes, opaque sessions, atomic spins with idempotency, ledger, XP/levels, achievements, missions, daily & rescue rewards, leaderboards, TOTP admin.14- `apps/web` — Next.js 16 front-end: landing, lobby, PixiJS game screen with procedural art and WebAudio sound, rewards, leaderboards, profile, settings, admin console.15- `apps/simulator` — multi-threaded CLI (`pnpm sim …`).1617See `CLAUDE.md` for the working guide and `docs/SPEC-original.md` for the product brief.1819## Quick start2021```bash22pnpm install23createdb spinza24pnpm db:migrate && pnpm db:seed25pnpm dev:api # http://127.0.0.1:823126pnpm dev:web # http://localhost:823027```2829Requires Node ≥ 22, pnpm 11, PostgreSQL 17 and Redis on localhost.3031## Certification3233Every game ships with `games/certifications/<slug>.json`; the seed publishes a game only when the report is `PASS` for the exact version. Re-certify after any math change:3435```bash36pnpm sim calibrate <slug> --spins 1000000037pnpm sim certify <slug> --spins 1000000038```39