RetentionPlayRetention & gamification infrastructure

Branded mini-games, progression, rewards and anti-fraud — with an authoritative backend. Integration guides for your team and an internal map of the codebase.

Integration guide

Internal docs

API reference

Embed in minutes

One script tag or SDK call mounts a sandboxed iframe widget. Issue an identified token through the API from your backend, or use anonymous free-play.

Server-authoritative

Progression, rewards, caps, cooldowns and anti-fraud are decided on the backend. The widget is a thin client, never the source of truth.

Signed webhooks

Reward callbacks are HMAC-signed with replay protection and idempotency keys, so material rewards stay safe.

Server game mechanics

Match3, Memory and Parcel Pilot use server-computed GameRun commands. Reward Wheel R1 has its own spin API. Older event templates use SpecEngine.

Beautiful API reference

The full /v1 OpenAPI spec is rendered here, and a live interactive Swagger UI is served by the API at /docs.

Internal project map

A per-folder guide to backend crates, the engine, frontend admin, widget, deploy and the architectural decisions behind them.

Two documentation tracks

Integration — for external teams embedding RetentionPlay: business overview, SDK usage, widget embed, webhooks, security and CMS recipes.
Internal — for working on RetentionPlay itself: architecture, backend crates, engine internals, deploy and decisions.

This site is generated from Markdown with VitePress and rebuilt as the product evolves. See the contribution rules in AGENTS.md.