Skip to content

sharadhiadiga/mathquest

Repository files navigation

🎲 Math Quest – Gamified Math Learning

Welcome to Math Quest – a fun and interactive platform where learning math feels like an adventure! Solve quizzes, earn XP, level up, and unlock new topics as you master Algebra, Geometry, Trigonometry, and Calculus.


Features

User Authentication – Register and login to track your progress
Topic-Based Challenges – Algebra, Geometry, Trigonometry, and Calculus quests
XP & Level System – Earn experience points and unlock advanced topics
Badge Rewards – Get badges for achievements
Data Persistence – All progress is saved using LocalStorage
Responsive Design – Mobile-friendly UI using Tailwind CSS
Modern Setup – Built with Vite for fast development


🛠 Technologies Used

  • 📄 HTML5 – Structure and layout
  • 🎨 CSS & Tailwind CSS – Styling and responsive design
  • 📟 JavaScript – Core logic and math generators
  • 💾 LocalStorage – Save user data locally
  • 🚀 Vite – Fast and optimized development environment

📥 Installation Instructions

🔑 Prerequisites

  • Node.js (v18 or later)
  • Git installed

🚀 Setup Steps

  1. Clone the repository
    git clone https://github.com/yourusername/mathquest.git
  2. Navigate into the project folder
    cd mathquest
  3. Install dependencies
    npm install
  4. Start the development server
    npm run dev
  5. Open in browser Visit the local URL provided (usually http://localhost:5173)

📂 Project Structure

mathquest/

├── index.html

├── styles.css

├── script.js

├── tailwind.config.js

├── package-lock.json

├── .gitignore

├── README.md

🎯 How to Use

➕ Register with your name, username, and password

🔑 Login to access your dashboard

📚 Choose a topic and start solving questions

⚡ Earn XP and unlock new topics

🏆 Track your progress and achieve badges

📜 License

This project is open-source and available under the MIT License.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors