Galactic Math
Space themed math trainer for elementary school kids
✨ Features
- 20-question quizzes — multiplication, division, addition, subtraction, or any combo — randomized every time
- Pick your numbers — select any combination of 0–13
- Keyboard-first navigation — Enter to submit, no mouse needed
- Space sound effects — lightsaber hums, droid beeps, and blaster buzzes (Web Audio API, no files needed)
- Comet celebration — passing scores (75%+) trigger streaking comets across the screen
- Hyperspace mode — optional timed challenge: complete all 20 before the countdown hits zero (Wicked Easy / Harder / Hyperdrive)
- Kessel Run mode — race against the clock; wrong answers add a 5-second penalty
- Alien Invasion mode — canvas-based space shooter; pilot your rocket through 20 math gates, dodge asteroids and UFOs, and manage your oxygen supply
- Theme cycler — switch between Dark, Dim, Midnight, Deep Blue, and Retro color themes
- Session history — track your scores across all rounds without any persistent storage
- Live grading — see your score as you go, full breakdown at the end with missed problems reviewed
- Rank system — Youngling → Rebel Recruit → Padawan → Jedi Knight → Jedi Master ⭐
- Zero dependencies — one HTML file, works offline, no internet required after first load
🚀 Play It Now
👉 Launch Galactic Math
Or download index.html and open it in any modern browser.
🎮 How to Play
- Select which numbers you want to practice (e.g. just the 6s and 7s, or all 0–13)
- Select an operation mode (multiply, divide, add, subtract, or a combo)
- Pick a game — Galactic Math or Alien Invasion
- Pick your options: a game mode for Galactic Math (Standard, Hyperspace, Kessel Run) or how bad the invasion is for Alien Invasion
- Check the Mission Briefing and hit Begin Mission
- Type your answer and press Enter
- Finish all 20 to see your rank and review any missed problems
🛠 Run Locally
No build step, no server required.
git clone https://github.com/bmschimmel/galactic-math.git
cd galactic-math
open index.html # macOS
# or just double-click index.html in your file explorer
📚 How It Works — Developer Docs
| File | What it covers |
|---|
| docs/overview.md | Architecture, file structure, screens, global state, deployment |
| docs/setup.md | Number selection, operation modes, game mode selection, Begin Mission |
| docs/quiz-engine.md | Question generation, answer submission, nav dots, live score |
| docs/game-modes.md | Standard, Hyperspace, Kessel Run, and Alien Invasion modes; rank system |
| docs/audio-engine.md | Web Audio API primitives and sound library |
| docs/visuals.md | Starfield, ring shockwave, comet celebration, hyperspace jump, CSS animations |
| docs/ui.md | Theme cycler, session history, keyboard navigation, mobile support |
| docs/design-ux.md | Design concept, color palette, typography, tone, wording, interaction patterns |
| docs/feedback-system.md | Feedback form, Cloudflare Worker, GitHub Issues integration |
| docs/CHANGELOG.md |
🤝 Contributing
Contributions? Yeah sure...it's a side project to help my kids learn math I don't know? Sure.
Open an issue or submit a PR.
📄 License
MIT — free to use, modify, and share. See LICENSE.
Built with vanilla HTML, CSS, and JavaScript. No frameworks. No trackers. No nonsense.
