Recipes¶
Copy-pasteable guides for the most common "add a thing" tasks. Each recipe points at a canonical example already in the codebase, includes file:line references, and ends with a verification step.
Internal "add a thing" recipes¶
For developers extending Evospin's internal patterns (guards, queues, spans, etc.).
| Recipe | What you'll build |
|---|---|
| Add a REST endpoint | GET/POST behind JwtGuard with DTO, Swagger, throttler |
| Add a Prisma model | Model + migration in the split schema, seed, repository |
| Add a BullMQ queue | Producer + consumer with retry, backoff, Redis inspection |
| Add an RT socket event | Server/client event through the RT gateway |
| Add an E2E test | Playwright spec with auth, DB assertions, trace capture |
| Add an OTel span | Manual span wrapping a service method |
| Add a Grafana dashboard | Provisioned dashboard with spanmetrics PromQL |
Customer integration cookbook¶
For customer engineering teams customising Evospin (white-label, new providers, new currencies, new languages). Index at integration-cookbook.md.
| Recipe | What you'll build |
|---|---|
| Add a payment provider | New deposit/withdraw provider analogous to CCPayment / NowPayments / SkinDeck |
| Add a house game | New in-house game analogous to dice / plinko / mines / limbo |
| Customise branding | White-label logos, colours, copy, email templates, domain |
| Add a game-provider integration | New external slots / live-casino provider analogous to PM8 / ST8 / BGaming |
| Add a locale | New language (next-intl + translation file + RTL if applicable) |
| Swap the KYC vendor | Replace Sumsub with another KYC provider |
| Enable a feature flag | Toggle existing or introduce new GitLab Unleash flag |
| Add a currency | New fiat or crypto currency (deposits / play / withdrawals) |