Skip to content

Cartooli/math-boredgames

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

114 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎯 MathBored - Never Be Bored with Math Again

A world-class, free, open-source math learning and practice application for K-12 students.

License: MIT 100% Free

🌟 Features

📚 Comprehensive Coverage

  • All K-12 Topics: From counting to calculus
  • 44 Math Concepts: Based on standardized K-12 curriculum
  • Grade-Specific Content: Automatically filtered by grade level

🎮 Three Learning Modes

  1. 📝 Lesson Mode

    • In-depth explanations of each concept
    • Real-world examples and applications
    • Key formulas and properties
    • Visual examples with step-by-step breakdowns
  2. 🔍 Walkthrough Mode

    • Detailed step-by-step problem solutions
    • See exactly how to solve each problem
    • Learn the reasoning behind each step
    • Perfect for understanding methodology
  3. 💪 Practice Mode

    • Unlimited practice problems
    • Instant feedback on answers
    • Detailed solution explanations
    • Adaptive difficulty based on grade level

🎨 Beautiful Design

  • 6 Color Themes: Midnight, Ocean, Forest, Sunset, Purple, and Light
  • Responsive Design: Works on desktop, tablet, and mobile
  • Smooth Animations: Engaging and modern UI
  • Accessible: High contrast and readable

📊 Progress Tracking

  • Streak Counter: Track consecutive correct answers
  • Score System: Earn points for correct answers
  • Accuracy Percentage: See your overall performance
  • Local Storage: Your progress is saved automatically

🚀 Getting Started

Installation

It's just one HTML file with no dependencies!

  1. Clone the repository:
git clone https://github.com/yourusername/math-boredgames.git
cd math-boredgames
  1. Open index.html in your browser:
# On Mac
open index.html

# On Linux
xdg-open index.html

# On Windows
start index.html

That's it! No build process, no dependencies, no server required.

Or Use a Local Server

For the best experience:

# Python 3
python -m http.server 8000

# Python 2
python -m SimpleHTTPServer 8000

# Node.js (if you have npx)
npx http-server

Then visit http://localhost:8000

📖 Topics Covered

Elementary School (K-5)

  • Counting and Cardinality
  • Number Recognition
  • Addition and Subtraction
  • Place Value
  • Even and Odd Numbers
  • Skip Counting
  • Multiplication and Division
  • Fractions
  • Decimals
  • Prime Numbers
  • Order of Operations (PEMDAS)

Middle School (6-8)

  • Integers
  • Ratios and Proportions
  • Percentages
  • Coordinate Plane
  • Expressions and Equations
  • Inequalities
  • Area and Volume
  • Pythagorean Theorem
  • Slope
  • Exponents

High School (9-12)

  • Polynomials
  • Quadratic Equations
  • Functions
  • Factoring
  • Trigonometry
  • Probability and Statistics
  • Law of Sines and Cosines
  • Logarithms
  • Exponential Functions
  • Derivatives and Integrals
  • Sequences and Series
  • Matrices
  • Standard Deviation

🎨 Customization

Themes

Click on any color circle in the header to change themes:

  • 🌑 Midnight: Classic dark theme (default)
  • 🌊 Ocean: Calming blue tones
  • 🌲 Forest: Natural green theme
  • 🌅 Sunset: Warm orange theme
  • 💜 Purple: Vibrant purple theme
  • ☀️ Light: Clean light theme

Your theme preference is saved automatically!

🤝 Contributing

We welcome contributions! This project is 100% free and open source.

How to Contribute

  1. Add More Lessons: Expand lesson content for existing topics
  2. Improve Problem Generators: Make practice problems more diverse
  3. Add Visualizations: Create diagrams and interactive visuals
  4. Enhance Explanations: Make walkthroughs even clearer
  5. Fix Bugs: Found an issue? Submit a PR!
  6. Suggest Features: Open an issue with your ideas

Development

The codebase is intentionally simple:

  • index.html - Main HTML structure
  • styles.css - All styling and themes
  • data.js - Math concepts data
  • app.js - Application logic
  • K12_Math_Concepts_Structure.csv - Source curriculum data

No build tools, no frameworks, just vanilla JavaScript!

Essential Math Primer

The Primer is a standalone 105-lesson curriculum in the primer/ directory. Lesson HTML is generated from content modules in scripts/:

npm run generate-primer   # regenerate all primer/*.html

📱 Browser Support

Works on all modern browsers:

  • ✅ Chrome/Edge (recommended)
  • ✅ Firefox
  • ✅ Safari
  • ✅ Mobile browsers

📝 License

MIT License - feel free to use this for any purpose!

🙏 Credits

  • Curriculum Data: Based on Common Core State Standards
  • Design Inspiration: Modern educational apps
  • Built with: Pure HTML, CSS, and JavaScript

💬 Philosophy

Always Free

This project will always be 100% free. No ads, no subscriptions, no hidden costs. Education should be accessible to everyone.

Open Source

All code is open source and available for anyone to use, modify, and learn from.

No Sign-Ups Required

Start learning immediately. No accounts, no tracking, no data collection.

Privacy First

All your progress is stored locally in your browser. We don't see or collect any data.

🎯 Mission

To provide a world-class, free math education resource that helps students:

  • Build confidence in mathematics
  • Learn at their own pace
  • Practice without pressure
  • Master concepts through repetition
  • Never be bored with math again!

🌐 Live Demo

Visit: math.boredgames.site

💡 Tips for Students

  1. Start with Lessons: Read the lesson before practicing
  2. Use Walkthroughs: See how problems are solved step-by-step
  3. Practice Regularly: Consistency is key to mastering math
  4. Don't Rush: Take your time to understand each concept
  5. Track Progress: Watch your streak and accuracy improve!

🔧 Technical Details

  • Size: ~50KB total (unminified)
  • Dependencies: None!
  • Framework: Vanilla JavaScript
  • Storage: LocalStorage for stats
  • Offline: Works completely offline after first load

📚 Educational Standards

Aligned with Common Core State Standards for Mathematics (K-12)

💬 Feedback & Support

Anonymous Feedback Form

Look for the floating 💬 feedback button in the bottom-right corner of the app!

Your feedback is completely anonymous and private - no login required, no email needed (unless you want a response).

Click the 💬 button to:

  • Share your thoughts
  • Report bugs or issues
  • Suggest features
  • Ask questions
  • Rate your experience

Privacy First: We respect your privacy. All feedback is anonymous by default and only visible to the maintainers.


👨‍💻 For Developers & Contributors

Interested in contributing code or reporting technical issues?

We keep GitHub information separate from the app to protect user privacy and reduce spam.

🎉 Acknowledgments

Special thanks to:

  • Educators who reviewed the content
  • Students who tested the app
  • Contributors who helped improve it
  • The open-source community

Made with ❤️ for students everywhere

Never be bored with math again!

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages