truth-for-a-win is a multiplayer, casino-type game played with an in-game currency called tokens. Players log in with a simple username that the browser saves, host matches that other players can join, and play against a bot dealer. The product includes Texas Holdem, blackjack, a die betting game, and a lottery that draws once every three hours with tickets costing 500 tokens. A leaderboard lets players compare results.
The audience is adult casual players who want a tense, precise, premium private-gaming experience rather than a cartoon app. The product intent is a self-contained token casino: a player arrives, establishes a username, receives a starting balance, and can host or join matches, bet on dice, buy lottery tickets, and track standing on the leaderboard.
This document is the System Requirements Document for the product requested under the project name truth-for-a-win.
truth-for-a-win is delivered as a first-party web application with a React frontend and a shared FastAPI backend, backed by MariaDB for durable application data and Redis for shared live state and coordination. All game surfaces — matches, Texas Holdem, blackjack, dice, lottery, and leaderboard — are owned and rendered by the application.
Identity is deliberately minimal: the player enters a simple username, and the browser saves it so the player returns to the same identity on later visits. There is no password, email, or external identity provider. The username is the player's durable identity for token balance, daily grants, lottery tickets, match participation, and leaderboard standing.
The lottery draw is a background process that runs once every three hours; the daily 1,500-token grant is a background process that runs once per day per player. Both are system-driven, but their results are observable to the player on the Lottery surface and in the token balance.
The bot dealer is a system actor inside matches; it is not a human persona and has no page of its own.
Removed from scope: none. No concept from the authoritative requirement thread was removed or replaced.
Not applicable — no reference directive with content_source was supplied.
FR-1 — Multiplayer casino game. As a Player, I should play a multiplayer casino-type game so that I can compete with other players. (explicit)
FR-2 — Host a match. As a Match host, I should host a match so that other players can join it. (explicit)
FR-3 — Join a match. As a Player, I should join an open match so that I can play with other players. (explicit)
FR-4 — Bot dealer. As a Player, I should play against a bot dealer so that matches can run without a human dealer. (explicit)
FR-5 — Texas Holdem. As a Player, I should play Texas Holdem in a match with the bot dealer. (explicit)
FR-6 — Blackjack. As a Player, I should play blackjack in a match with the bot dealer. (explicit)
FR-7 — Die betting game. As a Player, I should bet tokens on a die roll. (explicit)
FR-8 — Lottery. As a Player, I should buy lottery tickets and see the draw so that I can win the prize pool. (explicit)
FR-9 — Lottery ticket price. As a Player, I should pay exactly 500 tokens per lottery ticket. (explicit)
FR-10 — Lottery draw cadence. As a Player, I should see the lottery draw once every three hours. (explicit)
FR-11 — Simple username login. As a Player, I should log in with a simple username so that I can enter the game. (explicit)
FR-12 — Browser-saved username. As a Player, I should have my username saved in the browser so that I return to the same identity. (explicit)
FR-13 — Token currency. As a Player, I should use tokens as the game currency for all bets and purchases. (explicit)
FR-14 — Starting balance. As a Player, I should receive 10,000 tokens when I start the game. (explicit)
FR-15 — Daily grant. As a Player, I should receive 1,500 tokens each day. (explicit)
FR-16 — Leaderboard. As a Player, I should view a leaderboard so that I can compare my results with others. (explicit)
Muse: MARQ by Garmin — precision instrument luxury. Headline register: tense, precise, premium private gaming instrument.
Mode: Dark only.
Colour tokens (exact hex by role):
#14171A#1E2328#EDE6D8#C8A45C#2FB6A8#8A9199Typography:
clamp(44px, 9vw, 112px).Shape language: Circular gauges and bezels frame cards, dice, and timers. Ruled data rows and hairline dividers separate values. Corners are sharp with 2px radius.
Layout: One dark instrument panel fills the first screen. Left column holds the gauge hero; right column stacks a live table list and a token counter in ruled rows.
Imagery: Macro material shots of brushed titanium, felt, and engraved dice. Topographic line patterns sit behind data panels.
Avoid: No white or near-white ground; no blue or indigo accents; no rounded pill buttons or soft shadows; no gradient blobs or playful stickers; no centred headline with a stock subtext stack.
The public entry (Landing) is a full-bleed titanium panel. On the left, an oversized circular gauge occupies 70% of the viewport height; its dial shows the token balance and the three-hour lottery countdown, with a teal needle that sweeps once on load. The wordmark sits inside a thin bezel ring, not as plain text, flush left above the gauge, with the headline "Truth for a win" and subline "Host a table, take on the bot dealer and bet your tokens on the dice." in ivory. The "Enter the floor" call to action is a champagne primary control. Down the right edge runs a ruled column of live tables, each with a teal status dot and a condensed uppercase label. Every value row aligns number to number with hairline rules and tabular figures. The concept recomposes only accepted content and controls: the gauge visualizes the token economy and lottery cadence, and the live-table column previews the Matches surface.
Interaction Model: Animated Motion Tempo: restrained Hero Dimensionality: dimensional_css
Landing Hero Motion Brief
clamp(...) as needed. (creative direction)prefers-reduced-motion, a usable static arrangement is provided. (creative direction)
Host a table, take on the bot dealer and bet your tokens on the dice.

Host a table, take on the bot dealer and bet your tokens on the dice.
No comments yet. Be the first!