Skip to content

SteveMoraff/idle-math-clicker

Repository files navigation

Idle Math Clicker

A fast, browser‑based clicker that boosts points when you solve math prompts in real time. Questions span mental‑math skills (LCM/GCF, +/−, ×/÷), simple "solve for x", and light algebra. Designed to run full‑screen on desktop or mobile.

🌐 Live Demo

Add your live URL here (Repo → About → Website field and below):

https://yourdomain.com/idle-math-clicker

🎮 Gameplay Highlights

  • Clicker core: Earn points per click; solving questions increases the per‑click rate.
  • Instant checking: Answers validate on every keystroke; no submit button needed.
  • Multiple prompt lanes: Several questions shown at once; harder ones give bigger bonuses.
  • Math modes: Plus/Minus, Times/Division, Solve for x, LCM, GCF, Easy/Harder Algebra (toggleable).
  • Always‑focused input: Type to answer immediately; incorrect entries are ignored.
  • Fun effects canvas: Reserved canvas area for visual effects/3D scene.
  • Mobile friendly: Large controls; works in any modern browser.

🖥️ Run Locally

  1. Clone or download this repo.

  2. Open index.html directly in your browser or serve the folder with a simple static server:

    # any of these works
    python3 -m http.server 8000
    # or
    npx serve
  3. Navigate to http://localhost:8000 (if using a local server).

Note: The app is written in vanilla JavaScript (see script.js). The HTML just boots the JS and creates a full‑viewport UI.

🔧 Project Structure (typical)

index.html        # minimal loader
script.js         # all app logic & UI generation
textFit.js        # optional: auto-fit text to elements
assets/           # images, sounds (e.g., win.mp3, prime.ogg)

⌨️ Common Shortcuts

  • Full Screen button toggles full‑screen mode.
  • Menu / Reset Game buttons in the left control panel.
  • Spacebar can be bound to certain actions (e.g., GCF mode) if enabled in code.

🗺️ Roadmap Ideas

  • Save/load progress to localStorage.
  • Difficulty curves & pacing tweaks.
  • More effect presets and sound cues.
  • Optional GitHub Pages build for quick web hosting.

📝 License

MIT — see LICENSE for details.

🙌 Credits

Concept & development: Steve Moraff. Art assets/backgrounds: placeholders; replace with your licensed images.

About

Browser‑based clicker that boosts points when you solve math prompts in real time

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published