Skip to main content

MindGames

A modern mental math training application designed to improve arithmetic skills through chain-based problem solving.

What is MindGames?​

MindGames is a Next.js web application that generates linked math problem chains for mental arithmetic practice. Unlike traditional math drills, problems are connected - each answer becomes the starting value for the next problem, creating a flowing chain of calculations.

Key Features​

Chain-Based Problems​

24 → ÷4 → [?] → ×5 → [?] → +12 → [?] → -8 → [?]

Each answer feeds into the next problem, encouraging sequential mental calculation.

Operation Mix Control​

Customize the balance of operations with percentage-based presets:

  • Random: 25% each operation (equal distribution)
  • Basic: 40% add, 40% subtract, 10% multiply, 10% divide
  • Advanced: 20% add/subtract, 30% multiply/divide
  • Expert: 10% add/subtract, 40% multiply/divide

Kid/Adult Profiles​

  • Kid Mode: Encouraging messages, confetti celebrations, fun language
  • Adult Mode: Clean, focused interface for serious practice

Responsive Design​

  • Wide desktop layout (1600px) with persistent sidebar
  • Mobile vertical layout with full equations (e.g., 32 × 3 = ?)
  • Collapsible settings on mobile devices
  • Dark/light theme support

Technology Stack​

LayerTechnology
FrameworkNext.js 14 (App Router)
LanguageTypeScript
StylingTailwind CSS
StateReact Context + useReducer
IconsLucide React
Animationscanvas-confetti
TestingJest + React Testing Library

Architecture Overview​

Quick Start​

# Clone and install
cd MindGames
npm install

# Run development server
npm run dev

# Run tests
npm test

# Build for production
npm run build

Version​

Current version: 1.2.0

See CHANGELOG.md for release history.