teal-prd
Lala's WorldPRD: PuzzleNaira Project Phase: MVP / Version 1.0 Target Market: Nigeria Currency: Nigerian Naira (₦) 1. Product Overview PuzzleNaira is a skill-based, competitive match-3 mobile game. It enables players to compete in 1v1 battles where the outcome is determined entirely by speed and strategy. By utilizing a Deterministic Shared Seed, the game ensures both players face the exact same board, eliminating the "luck" associated with traditional puzzle games. 2. Core Game Mechanics (Skill-First) To maintain its status as a Game of Skill under Nigerian law: The Shared Seed: Every match uses a pre-generated sequence of blocks. If Player A gets a red block in column 3, Player B is guaranteed to get the same block at the same point in their sequence. Win Conditions: Time Attack: Highest score at the end of 120 seconds. Objective Blitz: First to clear 20 "Ice Blocks" or specific colors. Scoring Logic: 3-match: 100 points. 4-match (Rocket): 300 points. 5-match (Color Bomb): 500 points. Combo Multiplier: Score increases by 0.5x for every cascade triggered by a single move. No Pay-to-Win: Power-ups cannot be bought. They are only generated via 4+ matches during gameplay. 3. Game Modes & Social 3.1 1v1 Battle (PVP) Real-Time (Sync): Live match. A "Ghost Bar" shows the opponent’s score progress in real-time to drive urgency. Asynchronous (Async): Play now, and the system matches you with an opponent's score later. Results are delivered via Push Notification. 3.2 Social Integration WhatsApp Challenges: Users can share a "Challenge Link." If a friend clicks it, they are taken directly into a private lobby to stake ₦ against each other. Leaderboards: Weekly Naira prizes for the top 100 players (funded by the platform as a marketing expense). 4. Economy & Wallet (Naira Focused) 4.1 Payment Gateways Primary Deposit: OPay & PalmPay (Direct API integration for "One-Tap" payments). Alternative Deposit: Paystack/Monnify for Bank Transfers and USSD. Withdrawals: Instant payouts to any Nigerian Bank or OPay/PalmPay wallet. 4.2 Prize Structure (20% Platform Rake) Entry Fee (Per Player) Total Pool Platform Rake (20%) Winner Prize ₦100 ₦200 ₦40 ₦160 ₦500 ₦1,000 ₦200 ₦800 ₦2,500 ₦5,000 ₦1,000 ₦4,000 4.3 Virtual Currency (Gems) Usage: Practice matches only. Retention: Users earn 50 Gems daily for logging in. Ad-Integration: Watch a rewarded video to earn 100 Gems. 5. Technical Requirements 5.1 Anti-Cheat & Security Server-Side Move Validation: The game client sends every "Swap" move to the server. The server re-calculates the score. If the client-reported score and server-calculated score mismatch, the match is voided and the player is flagged. Latency Compensation: The 120-second timer is handled locally but synced at 10-second intervals to prevent "Time Freezing" hacks. 5.2 Regulatory Compliance (Nigeria) Age Gate: Mandatory 18+ verification during signup. KYC: For withdrawals over ₦50,000, users must provide NIN or BVN for identity verification (AML compliance). Licensing: Requires a license from the National Lottery Regulatory Commission (NLRC) as a "Promotional/Skill-based" game. 6. Monetization Model Match Rake (Primary): The 20% fee taken from every cash match. Withdrawal Fee: A flat ₦50 fee per withdrawal to cover bank processing costs. In-App Purchases: Sale of "Aura" effects (visual matches), custom tile skins (e.g., "Naira Green" tiles), and Avatars. Rewarded Ads: Only available in the "Practice" or "Free-to-Play" section. 7. UI/UX Strategy for the Nigerian Market Data Saver Mode: Option to disable high-res animations to save mobile data. Low-End Device Optimization: Ensure the game runs smoothly on devices with 2GB RAM (common in the region). Trust Signals: A prominent "Transaction History" and "Verified Payout" badge on the home screen to build user trust in the cash mechanics. 8. Roadmap Phase 1 (MVP): 1v1 Async matches, OPay/PalmPay deposits, core Match-3 engine. Phase 2 (Social): WhatsApp Friend Challenges, Real-time Sync matches. Phase 3 (Scale): Weekly Tournaments, SDK for third-party developers to add more skill games. 9. KPI Targets Day 1 Retention: 35% Average Matches per User/Day: 5.5 Average Deposit Value: ₦1,000 Viral Coefficient (K-Factor): 0.2 (from WhatsApp invites) 14.6s info Google AI models may make mistakes, so double-check outputs. Start typing a prompt
Comments (0)
Sign in to leave a comment
System Requirements
System Requirements Document for teal-prd
1. Introduction
PuzzleNaira is a skill-based, competitive match-3 mobile game targeting the Nigerian market. The game allows players to engage in 1v1 battles where outcomes are determined by speed and strategy, using a Deterministic Shared Seed to ensure fairness. The game is designed to comply with Nigerian regulations for skill-based games and uses the Nigerian Naira (₦) as its currency.
2. System Overview
PuzzleNaira is delivered as a mobile game application with a focus on competitive gameplay and social interaction. The game supports asynchronous 1v1 matches, with future expansions planned for real-time matches and social features. The game economy is centered around cash matches and virtual currency (Gems) for practice. The application integrates with Nigerian payment gateways for deposits and withdrawals, ensuring compliance with local financial regulations.
2a. Product Interpretation and Delivery Boundary
PuzzleNaira is designed for the Nigerian market, using the Nigerian Naira for all transactions. The game is classified as a skill-based game, requiring players to demonstrate speed and strategy. The MVP phase includes asynchronous matches, with future phases expanding to include real-time matches and social challenges. The game requires mandatory age verification and KYC compliance for large withdrawals. The application supports low-end devices and includes a data saver mode to optimize performance.
2b. Source Content Inventory
Not applicable as no content source directive was provided.
2c. Page Content and Component Coverage
Landing
- Information: Introduction to PuzzleNaira, its skill-based nature, and Naira gameplay.
- Primary Actions: Navigate to Sign Up or Login.
- Components: Game overview, benefits of skill-based play, and call-to-action buttons.
Sign Up
- Information: User registration with age verification.
- Primary Actions: Complete registration, verify age.
- Components: Registration form, age verification prompt.
Login
- Information: User authentication for returning players.
- Primary Actions: Enter credentials, log in.
- Components: Login form, forgot password link.
Dashboard
- Information: Central hub for accessing game modes and wallet.
- Primary Actions: Enter practice or cash matches, view wallet.
- Components: Navigation menu, match options, wallet overview.
Practice
- Information: Entry to Gem-funded practice matches.
- Primary Actions: Start practice match, watch ads for Gems.
- Components: Match entry button, ad integration for Gem earning.
Cash Matches
- Information: Access to asynchronous cash matches.
- Primary Actions: Browse matches, start a match.
- Components: Match list, entry fee display, start match button.
Match
- Information: Gameplay workspace for active matches.
- Primary Actions: Make moves, view scores.
- Components: Game board, timer, score display.
KYC
- Information: Verification for large withdrawals.
- Primary Actions: Submit NIN or BVN.
- Components: Verification form, submission confirmation.
Wallet
- Information: Manage deposits and view balance.
- Primary Actions: Deposit funds, view balance.
- Components: Deposit options, balance display.
Withdraw
- Information: Request withdrawals with applicable fees.
- Primary Actions: Request withdrawal, complete KYC if needed.
- Components: Withdrawal form, fee display, KYC prompt.
Transactions
- Information: View financial history and payouts.
- Primary Actions: Review transactions.
- Components: Transaction list, payout verification badge.
Rewards
- Information: Claim daily Gems and earn through ads.
- Primary Actions: Claim Gems, watch ads.
- Components: Gem claim button, ad integration.
Shop
- Information: Purchase visual customizations.
- Primary Actions: Buy Aura effects, tile skins, avatars.
- Components: Shop catalog, purchase buttons.
Settings
- Information: Configure data saver and preferences.
- Primary Actions: Adjust settings.
- Components: Data saver toggle, preference options.
3. Functional Requirements
- As a Player, I should be able to register and verify my age to access the game. (explicit)
- As a Player, I should be able to log in to resume my game progress and access my wallet. (required_inference)
- As a Player, I should be able to participate in asynchronous 1v1 matches with deterministic shared-seed boards. (explicit)
- As a Player, I should be able to view and manage my wallet, including deposits and withdrawals. (explicit)
- As a Player, I should be able to earn and use Gems for practice matches. (explicit)
- As a Player, I should be able to purchase visual customizations in the shop. (explicit)
- As a Player, I should be able to view my transaction history and verify payouts. (explicit)
- As a Player, I should be able to configure settings for data saving and device optimization. (explicit)
- As a Player, I should receive push notifications for asynchronous match results. (required_inference)
- As a Player, I should be able to submit NIN or BVN for KYC verification when required. (explicit)
4. User Personas
- Player: Engages in practice and competitive matches, manages Gems and Naira funds, and receives winnings or notifications. Responsible for verifying age and identity for compliance.
5. Core User Flows
Player Registration and Login
- Player accesses the Landing page.
- Player selects Sign Up and completes registration with age verification.
- Player logs in using credentials to access the Dashboard.
Asynchronous Match Participation
- Player navigates to the Dashboard.
- Player selects Cash Matches and browses available matches.
- Player starts a match and plays using the deterministic board.
- Player receives match results via push notification.
Wallet Management
- Player accesses the Wallet from the Dashboard.
- Player deposits funds using supported payment methods.
- Player requests a withdrawal, completing KYC if necessary.
Practice Matches and Rewards
- Player navigates to Practice from the Dashboard.
- Player starts a practice match using Gems.
- Player watches ads to earn additional Gems.
Customization and Settings
- Player accesses the Shop from the Dashboard.
- Player purchases visual customizations.
- Player adjusts settings for data saving and device preferences.
6. Visuals Colors and Theme
- Muse: Jessica Walsh
- Palette: Background #F5F5F5, Surface #FFFFFF, Text #333333, Primary #FF4081, Accent #FFEB3B, Muted #E0E0E0
- Typography: Headings in Archivo Black, Body in Nunito
- Shape Language: Bold color fields, overlapping shapes, sticker-like elements
- Layout: Dynamic grid, full-bleed sections, interactive overlays
- Motion: Bouncy scale-ins, marquee text, color flips on hover
7. Signature Design Concept
The Landing page features a bold, full-bleed hero with a vibrant pink block and oversized typography in Archivo Black. Interactive hover states flip colors and scale-in elements, creating a dynamic and engaging first impression.
8. Interaction Model & Motion Direction
- Interaction Model: Animated
- Motion Tempo: Expressive
- Hero Dimensionality: Layered_2d
- Landing Hero Motion Brief: The hero features a vibrant pink block with oversized typography overlaying a surreal, art-directed image. On hover, elements scale in and colors flip, creating an engaging and dynamic experience.
9. Non-Functional Requirements
- The game must support devices with 2GB RAM and provide a data saver mode. (explicit)
- The application must integrate with OPay, PalmPay, Paystack, and Monnify for financial transactions. (explicit)
- The game must comply with Nigerian regulations for skill-based games, including age verification and KYC. (explicit)
10. Tech Stack
- Frontend: React Native
- Backend: Python/FastAPI
- Storage: Appropriate cloud-based storage solution
- Deployment: Docker, Kubernetes (if required for scaling)
11. Assumptions and Constraints
- The target market is exclusively Nigeria, using Nigerian Naira for transactions.
- The MVP phase is limited to asynchronous matches and core functionalities.
- Future phases will expand to include real-time matches and social features.
12. Glossary
- Deterministic Shared Seed: A method ensuring both players face the same game board.
- Gems: Virtual currency used for practice matches.
- KYC: Know Your Customer, a process for verifying the identity of players.
- NIN/BVN: National Identification Number/Bank Verification Number used for identity verification in Nigeria.
Match. Battle.
Win Naira.
PuzzleNaira is a skill-based match-3 game where every board is identical for both players — a Deterministic Shared Seed means speed and strategy decide the winner, never luck.
Match-3 Skill.
Naira Stakes.
PuzzleNaira is a skill-based 1v1 match-3 game built for Nigeria. Every board is generated once from a Deterministic Shared Seed and handed to both players identically, so the only edge you get is your own speed and strategy. Play async, get your result by push notification, and cash out straight to your bank or mobile wallet.
Skill-Based Play
Every match is a head-to-head battle decided by how fast and how sharp you match blocks. No dice rolls, no random luck deciding your outcome.
Fair Competition
Both players face the exact same pre-generated sequence of blocks. If your opponent gets a red block in column 3, so do you, at the same point in the match.
Naira Earnings
Stake and win in Nigerian Naira. Winner takes the pool after a transparent 20% platform rake, with instant payouts to your bank or OPay/PalmPay wallet.
Strategy Focus
Chain cascades for a 0.5x combo multiplier and trigger 4+ matches to earn power-ups mid-game. No pay-to-win shortcuts, just sharper play.
Your first board is waiting
Sign up to get a fair, deterministic board every time you play — same blocks, same order, for both players. Log in if you already have an account to jump back into practice or cash matches.
18+ only. PuzzleNaira is a skill-based game. Age verification is required at signup, and withdrawals over ₦50,000 require NIN or BVN verification.
Match. Battle.
Win Naira.
PuzzleNaira is a skill-based match-3 game where every board is identical for both players — a Deterministic Shared Seed means speed and strategy decide the winner, never luck.
Match-3 Skill.
Naira Stakes.
PuzzleNaira is a skill-based 1v1 match-3 game built for Nigeria. Every board is generated once from a Deterministic Shared Seed and handed to both players identically, so the only edge you get is your own speed and strategy. Play async, get your result by push notification, and cash out straight to your bank or mobile wallet.
Skill-Based Play
Every match is a head-to-head battle decided by how fast and how sharp you match blocks. No dice rolls, no random luck deciding your outcome.
Fair Competition
Both players face the exact same pre-generated sequence of blocks. If your opponent gets a red block in column 3, so do you, at the same point in the match.
Naira Earnings
Stake and win in Nigerian Naira. Winner takes the pool after a transparent 20% platform rake, with instant payouts to your bank or OPay/PalmPay wallet.
Strategy Focus
Chain cascades for a 0.5x combo multiplier and trigger 4+ matches to earn power-ups mid-game. No pay-to-win shortcuts, just sharper play.
Your first board is waiting
Sign up to get a fair, deterministic board every time you play — same blocks, same order, for both players. Log in if you already have an account to jump back into practice or cash matches.
18+ only. PuzzleNaira is a skill-based game. Age verification is required at signup, and withdrawals over ₦50,000 require NIN or BVN verification.
No comments yet. Be the first!