MathThings!

A simple and interactive web app to practice multiplication tables with dynamic questions, instant feedback, and helpful hints.

What Is MathThings!

MathThings! is designed to help learners practice multiplication facts in a fun, engaging way. It generates a sequence of randomized multiplication questions based on selected tables and provides real-time feedback.

Why It Was Made

MathThings! was created to:

• Reinforce multiplication skills through repetitive, yet varied questions
• Offer immediate feedback and visually engaging responses (confetti, audio)
• Provide hints for common mistakes by loading mini-guides dynamically

Features

• Randomized Questions: Generate and shuffle combinations for selected times tables.
• Instant Feedback: Visual and audio cues for correct or incorrect answers.
• Dynamic Hints: Lazy-load hints from markdown files only when needed.
• Practice Statistics: Track progress and time elapsed.
• Responsive UI: Works across mobile and desktop with smooth layout transitions.

Getting Started

Requirements

• Node.js v16+ and npm/yarn

Self-Host Locally

1. Clone this repository:

   git clone https://github.com/chanvireak/maththings.git
   cd maththings

2. Install dependencies:

   npm install
   # or
   yarn install

3. Run in development mode:

   npm run dev
   # or
   yarn dev

4. Open http://localhost:3000 in your browser.

Production Build

npm run build
# or
yarn build
npm run preview
# or
yarn preview

Deploy to Netlify

1. Install Netlify CLI:

   npm install -g netlify-cli

2. Initialize your project:

   netlify init

3. Deploy to Netlify:

   netlify deploy --dir=dist --prod

To-Do

• Clean up the code and add comments
• Review and improve hint
• Add image to each hint
• Improve responsive design

Contributing

Contributions are welcome! Feel free to:

• Open issues for bugs or feature requests
• Submit pull requests with improvements
• Review and enhance the hints in trick-doc/

Support & Donations

If you find this tool helpful, please consider:

• ⭐️ Give the repo a star
• 📝 Review the hints and tricks
• ☕ Buy me a coffee: https://buymeacoffee.com/anntha

License

This project is open source under the MIT License.