Skip to content

ngpestelos/math-tutor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Math Frontier

Interactive math tutor from basic arithmetic to machine learning math. Built as a single HTML file with no dependencies.

What it does

  • 26 topics across 8 modules: Arithmetic, Algebra, Geometry, Trigonometry, Calculus, Probability & Statistics, Linear Algebra, ML Math
  • Prerequisite-based skill tree — topics unlock as you progress, preventing gaps
  • Diagnostic assessment — finds your knowledge frontier (where you'll learn fastest)
  • Socratic lessons — worked examples first, then guided practice, then independent problems
  • Timed drills — recall-first practice with 90% mastery gates
  • Multiple profiles — track progress independently (e.g. parent + kids)
  • All state in localStorage — no server, no account needed

Pedagogical design

Based on Justin Skycak's research on math education:

  • Knowledge Frontier Compression — teach only at the boundary of existing knowledge
  • Retrieval Practice — drills demand recall, not recognition
  • Automaticity gates — mastery required before advancement
  • Concrete Before Abstract — examples before definitions
  • Prerequisite diagnosis — the tool identifies gaps you can't see yourself

Run locally

python3 -m http.server 8788 --directory .
open http://localhost:8788

Opening index.html directly via file:// won't work — browsers block localStorage on file URLs.

Deploy

Hosted on Cloudflare Pages. Every git push auto-deploys.

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors