RandMatQuGeA (Random Math Question Generator App) 🧮 available at math.richardsblogs.com
A comprehensive, free online math question generator built with TypeScript that helps students practice algebra, calculus, trigonometry, and more with instant answer verification. Available as both a web application and cross-platform desktop app. Perfect for students, educators, and anyone looking to improve their math skills!
- 📚 125+ Math Topics: Comprehensive coverage from basic arithmetic to advanced calculus, discrete math, linear algebra, and geometry
- ⚡ Instant Feedback: Real-time answer checking with detailed explanations and LaTeX rendering
- 🖥️ Native Desktop Experience: Tauri-based desktop app with system tray, global shortcuts, and modern window effects (Mica on Windows, HUD on macOS)
- 💾 Persistent Storage: Built-in SQLite database for storing scores and progress (migrated from JSON)
- 🔘 System Tray & Global Shortcuts: Quick access and keyboard shortcuts for efficient workflow
- 🎨 Modern Window Effects: Transparent window backgrounds and platform-specific visual enhancements
- 📱 Responsive Design: Works seamlessly on desktop, tablet, and mobile devices
- 🎯 Progressive Difficulty: Questions adapt to different skill levels (easy, medium, hard)
- 🔢 Math Notation Support: Beautiful mathematical rendering with MathJax and KaTeX
- 🎲 Unlimited Questions: Generate endless practice problems
- 💡 Educational Focus: Designed specifically for learning and practice
- 🖥️ Cross-Platform Desktop App: Native desktop application built with Tauri v2 (Windows, macOS, Linux)
- 🔒 Type Safety: Fully migrated to TypeScript for robust, maintainable code
- 🧩 Modular Architecture: Organized into focused modules, each with many topic‑specific generator files
- ✅ Smart Answer Checking: Uses math.js to handle equivalent expressions, fractions, and LaTeX input
- 🔄 Graceful Exit: Clean application shutdown with resource cleanup
- No distractions or potentially hallucinated answers
- Unlimited structured practice
- Instant correctness verification
- Works offline as a desktop app
- Fully open-source & transparent
- Works fully offline
- No browser distractions
- Faster startup and lower memory usage than Electron apps
- Secure sandboxing with Rust + Tauri
- Modern window effects and system tray integration
- Global keyboard shortcuts for power users
- Persistent local database for progress tracking
- Ideal for focused study sessions
Download the latest installer from GitHub Releases:
- Windows:
.exe - macOS:
.dmg - Linux:
.AppImage/.deb
➡️ https://github.com/richie-rich90454/random-math-question-generator-app/releases
| Category | Topics |
|---|---|
| Arithmetic | Addition, Subtraction, Multiplication, Division |
| Algebra (Basics) | Fractions, Percentages, Ratios & Proportions, Unit Conversion, Expression Evaluation, Number Sets, Algebraic Properties, Order of Operations, Linear Word Problems, Radical Simplification, Radical Equations, Rational Exponents, Exponent Rules, Scientific Notation, Complex Numbers, Direct/Inverse Variation, Real Number Operations, Cartesian Plane, Special Linear Equations, Rational Equations, Roots, Logarithms, Exponentials, Factorials, Series, Function Properties, Basic Functions, Function Operations, Inverse Functions, Transformations, Power Function Modeling, Polynomial Inequalities, Polynomial End Behavior, Synthetic Division, Complex Zeros, Rational Graph Analysis, Circle Equations, Logistic Functions, Exponential Modeling, Logarithmic Modeling, Finance |
| Algebra (Advanced) | Linear Equations, Quadratic Equations, Linear Inequalities, Quadratic Inequalities, Rational Inequalities, 2×2 Systems, Polynomial Operations, Polynomial Division, Factoring, Function Concepts, Linear Graphs, Non‑Linear Graphs |
| Calculus | Limits, Derivatives (polynomial, trigonometric, exponential, logarithmic, product, quotient, chain, implicit, higher order, motion), Integrals (polynomial, trigonometric, exponential, logarithmic, substitution, definite, initial value, area, motion), Related Rates (ladder, cone), Limits & Continuity, Applications of Differentiation, Advanced Integration, Graphical Calculus, Parametric/Polar/Vector Calculus, Sequences & Series |
| Linear Algebra | Matrix Operations (add, subtract, multiply, inverse, transpose, scalar multiplication, power, row echelon), 3×3 Systems, Row Echelon Form, Partial Fractions, Linear Programming, 3D Vectors (magnitude, unit, dot, angle, projection), 3D Lines (parametric, point at given t), 3D Planes (distance, equation) |
| Trigonometry | Sine, Cosine, Tangent, Cosecant, Secant, Cotangent, Inverse Trig, Trig Equations, Trig Graphs, Degrees/Radians Conversion, Arc Length, Angular/Linear Speed, Right Triangle Definitions, Special Triangles, Elevation/Depression, Reference Angle, ASTC Signs, Sum/Difference Formulas, Double‑Angle Formulas, Half‑Angle Formulas, Polar/Rectangular Conversion, Polar Distance, Polar Graph Equations, Parametric → Cartesian, Parametric Motion, Complex Polar Form, Complex Multiply/Divide, De Moivre's Theorem, Complex Roots |
| Discrete Mathematics | Permutations (basic, equation, word, circular, identical, with replacement), Combinations (basic, equation, word, complement, paths, multiset), Probability (basic, conditional, independent, mutually exclusive, Bayes, binomial, expected value, complement, permutation/combination, geometric), Statistics (mean, median, mode, range, stem‑and‑leaf, box plot, standard deviation) |
| Geometry | Area (circle, rectangle, triangle, sector), Volume (sphere, cylinder, cone, pyramid, cube), Surface Area (cube), Triangles (Pythagorean theorem, similar triangles, classification), Perimeter, Arc Length, Distance Formula, Angle Relations, Conic Sections (parabola, ellipse, hyperbola, polar conics), 3D Geometry (distance/midpoint, sphere equations, lines/planes in 3D) |
Try it now: https://math.richardsblogs.com/
# Clone the repository
git clone https://github.com/richie-rich90454/random-math-question-generator-app.git
cd random_math_question_generator
# Install dependencies
npm install
# Start the development server
npm run devThen open http://localhost:1331 in your browser.
# Install Tauri CLI globally (if not already installed)
npm install -g @tauri-apps/cli
# Start Tauri development (runs both web dev server and desktop app)
npm run tauri dev
# Build desktop application for your platform
npm run tauri build- Select a Topic: Choose from 125+ math categories organized by subject
- Generate Question: Click "Generate Question" to get a new problem
- Enter Answer: Type your solution in the answer box
- Check Answer: Click "Check Answer" or press
Shift+Enterfor instant feedback - Learn: Review the correct answer rendered with KaTeX and a plain‑text alternate
- System Tray: Right‑click the tray icon to show the window or quit
- Global Shortcuts: Assign custom shortcuts via the Tauri configuration
- Window Effects: Mica on Windows 11, HUD on macOS, transparent background
- Graceful Exit: Closing the window hides it; use the tray "Quit" option to exit cleanly
- Frontend: HTML5, CSS3 (Custom Properties), TypeScript (ES2020)
- Math Rendering: MathJax 4.1.1 and KaTeX 0.16.11 for beautiful mathematical notation
- Build Tool: Vite 8.0.1 with TypeScript support for fast development and optimized builds
- Math Engine: Math.js 15.1.1 for complex calculations and equivalence checking
- Desktop Framework: Tauri v2 (Rust 1.85.0) with plugins for system tray, global shortcuts, and SQLite
- Database: SQLite via
sqlxfor persistent score storage - Type Safety: TypeScript 5.9.3 with strict configuration and comprehensive type definitions
- Build Tools: Vite 8.0.1 with oxc minification and LightningCSS
- Package Manager: npm with Node.js 18+
random_math_question_generator/
├── src/ # Source code directory
│ ├── index.html # Main web application interface
│ ├── script.ts # Core application logic (TypeScript)
│ ├── style.css # Responsive styling
│ ├── types/ # TypeScript type definitions
│ ├── modules/ # Modular math question generators
│ │ ├── Algebra/ # 40+ topic‑specific generator files
│ │ ├── Arithmetic/ # Basic arithmetic generators
│ │ ├── Calculus/ # Derivative, integral, limit generators
│ │ ├── LinearAlgebra/ # Matrix & vector generators
│ │ ├── Trigonometry/ # Trig function generators
│ │ ├── DiscreteMathematics/ # Combinatorics & probability
│ │ └── Geometry/ # Area, volume, triangle generators
│ ├── components/ # UI components
│ ├── utils/ # Utility functions (answer checking, formatting)
│ └── assets/ # Static assets
├── src-tauri/ # Tauri desktop application
│ ├── src/
│ │ ├── lib.rs # Main application logic
│ │ └── main.rs # Entry point (calls lib)
│ ├── Cargo.toml # Rust dependencies (sqlx, tauri‑utils, etc.)
│ └── tauri.conf.json # Tauri configuration (window effects, tray, etc.)
├── public/ # Public assets (fonts, MathJax)
├── dist/ # Build output
├── vite.config.ts # Vite build configuration
├── tsconfig.json # TypeScript configuration
├── CONTRIBUTING.md # Contribution guidelines
├── SECURITY.md # Security policy
└── README.md # This file
- Supports multiple correct answer formats (LaTeX, plain text, fractions, decimals)
- Handles mathematical equivalences using Math.js (e.g.,
2x↔2*x,(x+1)^2↔x^2+2x+1) - Provides detailed feedback with TypeScript‑safe structures
- Includes a
displayfield for rendering answers in KaTeX, separate from thealternateplain‑text representation - Vector notation support (angle brackets) and fallback numeric evaluation
- Progressive difficulty levels (easy, medium, hard)
- Clear mathematical notation with MathJax/KaTeX
- Instant feedback for learning
- Mobile‑friendly interface with keyboard shortcuts
- Fast server response times (static hosting)
- Optimized bundle sizes with Vite and TypeScript
- Efficient math calculations using math.js
- Responsive design with CSS custom properties
- Native performance with Tauri
- Small bundle sizes (10-20 MB)
- Secure sandboxing (Rust backend)
- Windows, macOS, and Linux support
- System tray integration with simple menu
- Global keyboard shortcuts for quick actions
- SQLite database for offline persistence
- Platform-specific window effects (Mica, HUD) and transparency
- Type Safety: Catch errors at compile time rather than runtime
- Better IDE Support: Enhanced autocomplete, refactoring, and documentation
- Improved Maintainability: Clear type definitions make code easier to understand
- Modern Development: Leverages latest ECMAScript features with type checking
- Organized by Subject: Each math category has its own module directory
- Focused Files: Large modules split into many small, topic‑specific generator files (e.g.,
generateFraction.ts,generateLogarithm.ts) - Reusable Utilities: Common functions extracted into utility files (e.g.,
algebraUtils.ts,trigUtils.ts) - Clear Exports: Each module has an
index.tsthat exports all public functions
The application is ready for deployment on any static hosting platform:
- Vercel, Netlify, GitHub Pages
- AWS S3, Google Cloud Storage, Azure Static Websites
Build cross-platform desktop apps with Tauri:
# Build for current platform
npm run tauri build
# Build for specific platform (requires cross-compilation setup)
npm run tauri build -- --target x86_64-pc-windows-msvc
npm run tauri build -- --target x86_64-apple-darwin
npm run tauri build -- --target x86_64-unknown-linux-gnu# Type checking (via tsc --noEmit)
npm run build:typescript
# Development with hot reload
npm run dev
# Production build
npm run buildThe project includes a GitHub Actions workflow that automatically builds and packages the application for all platforms when a new release is created.
Supported Platforms:
- Windows: 64-bit (.exe installers)
- macOS: Intel x64 & Apple Silicon (.dmg bundles)
- Linux: 64-bit (.AppImage & .deb packages)
How to create a release:
- Go to GitHub repository → Releases → Create a new release
- Create a tag (e.g.,
v1.9.0) - Add release title and description
- Click "Publish release"
The workflow will automatically:
- Build the web application
- Build desktop apps for all platforms
- Generate release notes with download links
- Upload all artifacts to the release
Cost: FREE for public repositories (uses ~30 minutes of GitHub Actions time per release)
We welcome contributions! Please see our CONTRIBUTING.md for detailed guidelines.
Here's how you can help:
- Report Bugs: Open an issue with detailed descriptions
- Suggest Features: Share your ideas for new math topics or features
- Improve Documentation: Help make the project more accessible
- Submit Code: Fork the repo and create pull requests
git clone https://github.com/richie-rich90454/random-math-question-generator-app.git
cd random_math_question_generator
npm install
# For web development
npm run dev
# For desktop app development
npm run tauri dev
# For TypeScript type checking
npm run build:typescriptWe take security seriously. Please see our SECURITY.md for reporting vulnerabilities.
- 125+ Math topics supported
- 10,000+ Lines of educational TypeScript code
- 7 Major math categories
- 100+ Module files organized by subject
- Unlimited Question combinations
- Instant Answer verification
- Cross-platform Desktop application
- TypeScript for robust development
This project is licensed under the Apache License 2.0. See the LICENSE file for details.
- Live Demo: https://math.richardsblogs.com/
- GitHub Repository: https://github.com/richie-rich90454/random-math-question-generator-app
- Main Website: https://www.richardsblogs.com
- Tauri Framework: https://tauri.app/
- Vite Build Tool: https://vitejs.dev/
- TypeScript: https://www.typescriptlang.org/
⭐ If you find this project helpful, please consider giving it a star! ⭐
Your support helps more people discover this valuable learning tool and encourages further development.