Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

LessUp/mind-gym

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

108 Commits

Repository files navigation

๐Ÿง  Mind Gym

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

CI Docs Pages License: MIT PWA

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

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


๐Ÿ“˜ Whitepaper Site โ€ข ๐ŸŽฎ Playable Demo

๐ŸŽฌ 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 / ร—ใฐใค5 / ร—ใฐใค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

About

๐Ÿง  Browser-based memory training PWA with FSRS-4.5 spaced repetition, N-back training, and adaptive difficulty | ๅŸบไบŽ FSRS-4.5 ้—ด้š”้‡ๅคใ€N-back ่ฎญ็ปƒๅ’Œ่‡ช้€‚ๅบ”้šพๅบฆ็š„ๆต่งˆๅ™จ่ฎฐๅฟ†ๅŠ›่ฎญ็ปƒ PWA

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

Contributors

AltStyle ใซใ‚ˆใฃใฆๅค‰ๆ›ใ•ใ‚ŒใŸใƒšใƒผใ‚ธ (->ใ‚ชใƒชใ‚ธใƒŠใƒซ) /