Solo•Shipped v1.0.0+12•May 2026 – Aug 2026
Tuko Kadi — Offline-First P2P Multiplayer Card Game
Console-quality mobile adaptation of Kenyan card game Kadi with zero-infrastructure embedded WebSocket P2P multiplayer.

Tuko Kadi — Offline-First P2P Multiplayer Card Game Cover Banner
0k+
Lines of Dart (Solo)<0ms
Local P2P Latency$0/mo
Cloud Server Cost0+/sec
AI Match SimulatorThe Challenge
Problem & Context
Multiplayer mobile games typically require expensive cloud game servers and constant internet connectivity, excluding low-connectivity environments and incurring ongoing infrastructure bills.
A console-quality mobile adaptation of the Kenyan card game Kadi, playable with zero internet and zero backend cost across 55,650+ lines of Dart and 294+ commits, 100% solo-owned.
Architecture & Delivery
Key Architectural Highlights
Built a deterministic game engine and state machine (GameController, ValidationEngine, TurnManager) handling cascading combinations, penalty stacking, Jack deflections, and Super Ace demands.
Engineered zero-infrastructure P2P multiplayer by embedding an HttpServer + WebSocket host directly on-device with QR code pairing at sub-5ms local latency.
Made networking fault-tolerant with persistent clientId session recovery, automated reconnection, and turn-timeout fail-safes.
Built four behavioural AI opponents (The Meta, Simba, Kobe, Fisi) and a headless simulator running 500+ full 4-player matches in seconds.
Hand-built visual layer with 10 dark themes, 14 animated app bars, custom canvas avatar builder, and card-shatter particle physics.
Deep Dive
Engineering Challenges & Solutions
THE HARD PROBLEM
Handling out-of-turn card jumps, deflections, and penalty challenges in real-time without desynchronizing distributed peer game states.
THE ARCHITECTURAL SOLUTION
Isolated a pure ValidationEngine behind a negotiation state machine that freezes turn flow to dispatch interrupt prompts before resolving flow direction and penalties.
Technology Stack
Tools & Technologies Used
Mobile & Core
Flutter 3.xDart 3.xCustomPainterflutter_test
Networking
Embedded dart:io HttpServerWebSocketsQR Pairing
AI & State Engine
Deterministic State MachineBehavioural Bot AIHeadless Simulator
Monetization
AdMobIn-App Purchases / Play BillingBillingGuard
Interface Gallery
Visual Walkthrough & Captures

Gameplay Screen with Custom Canvas Card Physics

Local P2P QR Code Lobby Pairing

Selecting the Game Mode Screen