Abacus Arcade (Playful Mental Math)
Gamified mental arithmetic arcade across 6 adaptive levels with native audio and visual hints for kids and adults.
Interactive mental math arcade game crafted for kids (ages 5 to 11) and adults. Originating as a pioneering AI pair-programming case study (ChatGPT & Founderz Prompt Engineering), v2.0 introduces 6 adaptive levels (from primary foundations to adult mental agility challenges with combined operations and percentages), native 8-bit procedural Web Audio synthesis, visual math manipulatives with grouped objects, 3D on-screen tactile numpad for tablets, 3 game modes (Zen, Classic, and 60s Time Attack), and 6 collectible badges, operating 100% offline with zero external dependencies.
System Objectives
Create an engaging, tactile, and accessible arcade environment for mental arithmetic practice free of rigid corporate friction.
Provide an adaptive and fun experience for both primary school children and adults seeking cognitive agility.
Eliminate historical contract drift with native 8-bit audio synthesis, visual object manipulatives, and collectible badges.
Consolidate a Single-Source-of-Truth architecture without external CDN dependencies, preserving legacy SEO with redirection shims.
Key Capabilities & Modules
6 Adaptive Levels: ranging from 1-digit addition foundations to adult order of operations, missing unknowns, and percentages.
Interactive Math Manipulative: tangible visual representations (apples, stars, grids, and division boxes with remainder).
Tactile 3D Arcade Numpad: on-screen keypad preventing system soft keyboards from covering the play area on tablets and mobile devices.
Web Audio Synthesizer & Confetti: cheerful procedural 8-bit soundscapes, streak combo multipliers, and canvas confetti.
3 Game Modes & Badges: Zen Mode (relaxed), Classic (10 timed rounds), and 60s Time Attack with 6 unlockable badges.
100% Offline Installable PWA: home screen install button (Android, iOS, desktop), Service Worker cache, and zero network dependencies.
Deterministic Daily Challenge & Mistake Review: Wordle-style seed-based daily challenge, visual share card with deep linking, and pedagogical mistake review module.
Family Profiles & Arcade PNG Diploma: multi-player local switcher with isolated stats and high-resolution honors certificate PNG generator via native Canvas 2D.
Architecture & Design Specifications
Self-contained Single-Source-of-Truth client-side SPA in /apps/maths/: procedural math engine generates deterministic arithmetic challenges bounded by grade level, validating answers in browser memory. Eliminates legacy language folder duplication via unified i18n dictionaries and redirection shims in /es/ and /en/.
🔍 Click diagram to enlarge to fullscreen
Invariant Architectural Principles:
- Playful Pedagogy & Aesthetics (Consumer Playful): 3D arcade buttons, friendly visual hints, and positive reinforcement.
- Zero External Network Dependencies: 100% native CSS eliminating Tailwind CDN and blocking Google Fonts.
- Multi-Device Ergonomics: On-screen numpad for tablets and full keyboard shortcuts (0-9, Enter, Tab) for desktop.
Technology Stack
FRONTEND
AUDIO_CANVAS
PEDAGOGY
METHODOLOGY
HOSTING
Reference Articles & Architecture Series
This application is fully documented in an engineering series published on the blog:
Copiloting with AI: Learning with Founderz and ChatGPT
Learning how AI can be our day-to-day copilot thanks to Founderz, and how we can create useful and simple HTML applications with …
Read full article →Evolutionary History & Versions (SemVer)
Formal record of releases, feature additions, and security patches:
Abacus Arcade v2.3: Multi-Player Family Profiles and Arcade PNG Diploma Generator
- Family Profile Switcher ('🦁 Player 1', '🦊 Player 2', '🦉 Adult') isolating high scores, streaks, and unlocked badges in localStorage.
- Client-side Canvas 2D Arcade PNG Diploma generator: high-resolution (1200x800) mathematical excellence certificate with gold border, avatar, records, badge collection, and official stamp downloaded in 1 click.
- Direct diploma generation access from the Badges tab and on the post-game victory screen upon setting new milestones.
Abacus Arcade v2.2: Deterministic Daily Challenge, Wordle Share, and Mistake Review
- New '📅 Daily Challenge' mode with Mulberry32 deterministic PRNG: identical date YYYY-MM-DD and level generate 10 strictly reproducible problems for fair competition.
- Wordle-style visual performance strip (🟩 clean hit, 💡 hit with visual hint, 🟥 mistake) on the post-game summary.
- '📤 Share Result' button with automatic formatted clipboard card copy and deep link '?mode=daily&level=...'.
- Pedagogical '🧠 Round Mistake Review' module: breakdown of missed operations with correct solution and on-demand visual hints.
Abacus Arcade v2.1: 100% Offline PWA Support, Install App Button, and Formative Feedback
- Full offline PWA with Service Worker (sw.js), manifest.json, and full raster/adaptive PNG icon set (maskable 192/512 for Android and iOS) with 80% circular safe-zone.
- Reactive PWA Update Module: floating '⚡ New version available' banner with 1-click update and interactive version badge (`#btn-check-update`) for instant manual update verification without uninstalling.
- Dynamic header '📲 Install App' button capturing beforeinstallprompt and step-by-step guidance for iOS Safari and desktop.
- Pedagogical formative feedback banner on each answer (instant positive points reinforcement or 1.8s explained solution).
- Anti-FOUC persistence for Daylight/Cosmic Night themes, localStorage sound state, and quick keyboard shortcuts (T, M, H).
- Removal of browser native confirm() popups, replaced by playful floating toast notifications.
Comprehensive Abacus Arcade v2.0 evolution: 6 adaptive levels (kids and adults), native audio, and visual manipulatives
- Expanded level system to 6 adaptive tiers, from kindergarten foundations to adult arithmetic agility and percentages.
- Native 8-bit procedural Web Audio synthesizer and Canvas confetti physics engine (closing contract drift).
- Visual math manipulative displaying concrete representations (blocks, fruit, multiplication grids, and division boxes).
- On-screen 3D arcade numpad for optimal tablet and mobile ergonomics without virtual keyboard obstruction.
- 3 game modes (Zen relaxed, Classic 10 rounds, and 60s Time Attack) and 6 collectible achievement badges.
- Single-Source-of-Truth architecture in /apps/maths/, removal of external CDN dependencies (Tailwind), and legacy SEO shims.
Official Interactive Maths release featuring 4 academic tiers and bilingual deployment
- Integration of 4 core operations (addition, subtraction, multiplication, division) and 4 school tiers.
- 1 and 2-digit difficulty toggle with introductory didactic learning module.
- Gamified scorekeeper with dynamic emojis and visual feedback.
- Localization support with independent routes in Spanish (/es/) and English (/en/).
- Frozen state as an educational showcase and AI pair-programming case study.
Multiplication, division, and round timer
- Addition of advanced multiplication and division operations with interactive round timer.
First functional prototype with addition and subtraction
- Initial interactive arithmetic prototype generated through guided ChatGPT conversation.