Skip to content

LessUp/mind-gym

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

65 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿง  Mind Gym

Browser-based cognitive training with adaptive difficulty, N-back training, and spaced repetition

CI Deploy License: MIT PWA

English โ€ข ็ฎ€ไฝ“ไธญๆ–‡

Zero dependencies โ€ข Works offline โ€ข Bilingual (EN/ZH)


๐ŸŽฎ Play Now

๐ŸŽฌ Preview

Mind Gameplay - 6x6 Grid Mind Features - Achievements

N New Game ยท P Pause ยท H Hint ยท โ†‘โ†“โ†โ†’ Navigate ยท Enter Flip


โœจ Features

5 science-backed training modes to improve cognitive function:

Mode Focus Description
Classic Visual memory Match pairs in 4ร—4 / 4ร—5 / 6ร—6 grids
Countdown Speed Race against time limits
Daily Challenge Consistency Same layout for all players worldwide
N-back Working memory Match stimulus N steps back
Delayed Recall Long-term memory Post-game recognition test

Adaptive Intelligence: ELO-like rating (600-1600) auto-adjusts difficulty based on your performance.

Fully Featured: ๐ŸŒ i18n (auto-detected) โ€ข ๐Ÿ“ฒ PWA installable โ€ข โŒจ๏ธ Keyboard navigation โ€ข ๐Ÿ’พ Export/JSON backup โ€ข ๐Ÿ† Achievements


๐Ÿš€ Install as PWA

Desktop (Chrome/Edge): Visit site โ†’ Click โž• install icon โ†’ Launch from desktop

iOS Safari: Share โ†’ "Add to Home Screen"

Android Chrome: Menu โ†’ "Add to Home screen"


๐Ÿ›  Development

git clone https://github.com/LessUp/mind-gym.git
cd mind-gym && npm install
npm test           # Run unit tests
npm run build:css  # Compile Tailwind

Stack: Vanilla JS (ES2022) โ€ข Tailwind CSS 3.4 โ€ข Jest 30 โ€ข GitHub Pages

  • โšก <100KB total (no runtime dependencies)
  • ๐ŸŽฏ Lighthouse 95+
Project Structure
โ”œโ”€โ”€ index.html    # SPA entry
โ”œโ”€โ”€ app.js        # Game orchestrator
โ”œโ”€โ”€ sw.js         # Service Worker
โ”œโ”€โ”€ src/          # Core modules
โ”‚   โ”œโ”€โ”€ storage.js, stats.js, modes.js, i18n.js, fsrs.js
โ”œโ”€โ”€ __tests__/    # Jest tests
โ”œโ”€โ”€ docs/         # User guides
โ””โ”€โ”€ openspec/     # Spec-driven development
    โ””โ”€โ”€ specs/    # Capability specifications

๐Ÿ“– Documentation


๐Ÿค Contributing

See CONTRIBUTING.md. Steps: Fork โ†’ Review specs โ†’ Code โ†’ Test (npm test) โ†’ PR


๐Ÿ“œ License

MIT License ยฉ LessUp


Made with โค๏ธ for cognitive health