Pokémon Find // Real-Time Guessing Game
Real-time multiplayer and solo web game based on the National Pokédex: 15-second countdown to identify Pokémon by number, proximity scoring algorithm, synchronized rooms, and autonomous Docker container.
Role
Architecte & Développeur Full-Stack
Year
2026
Tech_Stack
// The_Challenge
// The_Challenge
The Challenge
Build an ultra-responsive real-time multiplayer web game synchronizing up to 8 players per room with sub-50ms latency, strict server-side anti-cheat validation, multi-generational selection across 1,025 Pokémon, and zero runtime third-party API dependencies.
// The_Solution
The Architecture
Strict TypeScript pnpm monorepo architecture sharing a @pkfind/shared domain package between React 19 / Vite frontend and Node.js / Socket.IO server. Packaged into a self-contained single Docker container (no database or external service needed) with automated Ansible playbooks for Proxmox VM deployment and Traefik ingress.
// Impact_Metrics
The Impact
Comprehensive test suite (Vitest unit/integration and Playwright E2E), disconnect tolerance with seamless session token reconnection, near-instant response times, and fluid competitive experience across mobile and desktop.
Key Features
Surgical_Architectural_Execution
- 01
Solo, Daily Challenge & Blitz Modes: 10-round customizable games, shared UTC daily seed, and fast-paced countdown Blitz mode.
- 02
Real-Time Socket.IO Multiplayer: Private rooms for 2-8 players with 4-character room codes, QR code sharing, and automatic host handover.
- 03
Proximity Scoring Algorithm: Exponential point rewards based on distance to target Pokédex number (up to 1,000 pts for exact matches).
- 04
Interactive Pokédex & Player Telemetry: 1,025 Pokémon browser with local sprites, dual-type pills, generation filters, and player statistics dashboard.
// Interface_Gallery
Platform_Interface_Overview
Active Game Screen // In-Round
01Giant National Pokédex target number (#025), circular countdown ring timer with visual cues, and accessible smart autocomplete.
Round Reveal & Standings // Multiplayer
02Target Pokémon sprite reveal, precise score breakdown, and real-time multiplayer leaderboard displaying points delta and gap.
Pokédex Browser // Player Stats
03Complete browser across 1,025 Pokémon by generation and element types, paired with player telemetry (win rate, average response time).
Up_Next_Repo
Core Hub // LifeOS Monorepo
Link_Access_Protocol