Skip to main content
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
Tuko Kadi — Offline-First P2P Multiplayer Card Game Cover Banner
0k+
Lines of Dart (Solo)
<0ms
Local P2P Latency
$0/mo
Cloud Server Cost
0+/sec
AI Match Simulator
The 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
Gameplay Screen with Custom Canvas Card Physics
Gameplay Screen with Custom Canvas Card Physics
Local P2P QR Code Lobby Pairing
Local P2P QR Code Lobby Pairing
Local P2P QR Code Lobby Pairing
Selecting the Game Mode Screen
Selecting the Game Mode Screen
Selecting the Game Mode Screen