A fun and educational treasure-hunting adventure that helps children practice mathematics while exploring an exciting journey toward hidden treasures.
🌍 Multi-language support • 📱 Tablet friendly • 🔒 Privacy friendly • 📶 Offline capable • 🎮 Gamified learning
Live Demo: https://allessuper.github.io/math-treasure-quest/
- ➕ Addition (0–100)
- ➖ Subtraction (0–100)
- ✖️ Multiplication (1×1 to 10×11)
- 🗺️ Adventure-based progression system
- 💎 Unique treasure reward at the end of each journey
- 🌍 Multiple languages
- 📱 Optimized for tablets and desktop devices
- 🔒 No ads
- 🔒 No tracking
- 🔒 No account required
- 📶 Works offline as a Progressive Web App (PWA)
Choose your adventure and begin your treasure hunt.
Select math type, difficulty and optional timer mode.
Travel across the island and progress toward the hidden treasure.
Answer addition, subtraction and multiplication tasks to advance.
Reach the treasure and discover a unique reward at the end of every journey.
Choose from many languages including German, English, Spanish, French, Italian and more.
Math Treasure Quest was designed to make practicing mathematics fun and motivating for young learners.
Children improve:
- Mental arithmetic
- Problem solving
- Concentration
- Confidence with numbers
- Learning persistence through positive rewards
Visit:
https://allessuper.github.io/math-treasure-quest/
git clone https://github.com/AllesSuper/math-treasure-quest.git
cd math-treasure-questThen open:
index.html
in your browser.
Contributions, suggestions and feedback are welcome.
If you enjoy the project, consider giving it a ⭐ on GitHub.
MIT License
- 🗺️ Adventure map with a moving traveler and visible journey progress.
- 🧮 Three math modes plus a colorful mixed mode.
- 🎯 Adaptive difficulty that grows and eases with the child.
- 💡 Helpful hints appear after a mistake — never punishing, always guiding.
- ⭐ Stars, 🔥 streaks, 🪙 coins, 🎖️ badges and a 💎 random treasure each run.
- ⏱️ Optional timer mode and ⚡ quick mode (10 tasks).
- 🌍 16 languages, German first; choice saved on the device.
- 📱 Installable PWA — add to the iPad home screen and play offline.
- 🎨 Premium cartoon look built only from original CSS/SVG/HTML graphics.
- 🔒 No backend, no login, no tracking, no ads, no external APIs.
Most free math games for kids are buried in ads, demand accounts, or quietly track children. Parents and teachers deserve something better: a calm, friendly, self-contained tool that respects the child and the family.
Mathe-Schatzreise is intentionally tiny and transparent. Anyone can read every line, host it for free, and trust that nothing is happening behind the scenes. It is a gift to families, classrooms, and the open-source community.
- Reinforces number bonds to 100 through repeated, varied practice.
- Builds multiplication fluency with the 1×1 to 10×11 tables.
- Encourages a growth mindset: mistakes lead to hints, not dead ends.
- Uses immediate, encouraging feedback to keep motivation high.
- Short ~15-minute runs fit a child's attention span; quick mode fits a spare five minutes.
| Mode | Range | Notes |
|---|---|---|
| ➕ Addition | 2 or 3 numbers, each 0–100, sum ≤ 100 | Sums never exceed 100. |
| ➖ Subtraction | 0–100 | Result is never negative in normal play. |
| ✖️ Multiplication | 1×1 up to 10×11 | First factor 1–10, second factor 1–11. |
| 🌈 Mixed | All of the above | Randomly combined. |
- Open the live demo URL in Safari on the iPad.
- Tap the Share icon (the square with an upward arrow).
- Choose "Add to Home Screen".
- Confirm the name and tap Add.
- Launch Mathe-Schatzreise from the home screen — it runs full screen and works offline after the first load.
No build step and no dependencies are required. Any static file server works.
# Clone the repository
git clone https://github.com/USERNAME/math-treasure-quest.git
cd math-treasure-quest
# Option A: Node (uses the bundled npm script)
npm start # serves the app at http://localhost:8080
# Option B: Python (no Node required)
python3 -m http.server 8080Then open http://localhost:8080 in your browser.
Useful scripts (see package.json):
npm start # serve the app locally
npm test # run the math range/validation tests
npm run format # format files with PrettierService workers require
http://localhostor HTTPS. Openingindex.htmldirectly viafile://disables offline caching but the game still runs.
math-treasure-quest/
├── index.html # App shell and all screens
├── styles.css # Cartoon theme, layout, animations
├── app.js # Game engine, i18n, math generators
├── manifest.json # PWA metadata
├── service-worker.js # Offline-first cache
├── icons/
│ ├── favicon.svg # Original vector icon
│ ├── icon-192.png # PWA icon
│ ├── icon-512.png # PWA icon
│ └── icon-maskable-512.png
├── tests/
│ └── math.test.js # Range + validation unit tests (Node)
├── .github/
│ ├── workflows/
│ │ ├── pages.yml # Deploy static site to GitHub Pages
│ │ └── quality.yml # Lint/validate + run tests
│ ├── ISSUE_TEMPLATE/
│ │ ├── bug_report.yml
│ │ └── feature_request.yml
│ └── pull_request_template.md
├── README.md
├── LICENSE
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── SECURITY.md
├── CHANGELOG.md
├── ROADMAP.md
├── package.json
├── .gitignore
└── .editorconfig
- Large touch targets (≥ 64 px) designed for small hands.
- High-contrast text and readable, system-friendly font sizing.
- Full keyboard support: number keys, Backspace, Enter (check) and Escape (pause).
- Semantic landmarks,
aria-livefeedback regions and visible focus styles. - Respects
prefers-reduced-motionfor children sensitive to animation. - Right-to-left layout support (e.g. Arabic).
- A service worker pre-caches the full app shell on first load.
- After that, the game works with no network connection at all.
- Update the
CACHE_VERSIONconstant inservice-worker.jswhen you change cached assets to refresh clients. - Progress (coins, treasures, badges, language) is stored locally in
localStorage— nothing leaves the device.
This repository ships with a GitHub Actions workflow that publishes the static root of the project to GitHub Pages.
- Push the repository to GitHub.
- Open Settings → Pages and set Source to GitHub Actions.
- The
pages.ymlworkflow runs on every push tomainand deploys the site. - Your app appears at
https://USERNAME.github.io/math-treasure-quest/.
See ROADMAP.md for the full plan. Highlights:
- 🔊 Sound effects and gentle music
- 👪 Parent dashboard
- 🌍 More adventure worlds
- 📜 Printable certificates
- 🗣️ Expanded multilingual content
- 📊 Difficulty analytics
- 🏫 Classroom mode
Contributions are warmly welcome! Whether it is a translation, a bug fix, or a new idea, please read CONTRIBUTING.md and our Code of Conduct first.
Released under the MIT License. Free to use, share, remix and host.
If Mathe-Schatzreise helps a child you know enjoy math a little more, consider giving the project a star. It helps other parents and teachers discover it — and it genuinely makes the maintainers smile. Thank you for stopping by! 💛