{"id":30310708,"url":"https://github.com/rishilahoti/math-destroyer","last_synced_at":"2026-04-09T11:01:32.637Z","repository":{"id":308593454,"uuid":"1033376803","full_name":"rishilahoti/math-destroyer","owner":"rishilahoti","description":"A retro-style arcade game that combines fast-paced spaceship action with math challenges. Players control a spaceship and must shoot the correct answer to math problems displayed on enemy ships. The game blends education and entertainment, helping players improve their math skills while enjoying an engaging arcade experience.","archived":false,"fork":false,"pushed_at":"2025-08-06T19:42:58.000Z","size":2861,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-17T15:04:56.577Z","etag":null,"topics":["framer-motion","gsap","javascript","nextjs","retro","tailwind","tailwindcss","typescript","web-game","webapp"],"latest_commit_sha":null,"homepage":"https://math-destroyer.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rishilahoti.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-06T18:06:35.000Z","updated_at":"2025-08-06T20:22:17.000Z","dependencies_parsed_at":"2025-08-06T20:42:47.413Z","dependency_job_id":null,"html_url":"https://github.com/rishilahoti/math-destroyer","commit_stats":null,"previous_names":["rishilahoti/math-destroyer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rishilahoti/math-destroyer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rishilahoti%2Fmath-destroyer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rishilahoti%2Fmath-destroyer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rishilahoti%2Fmath-destroyer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rishilahoti%2Fmath-destroyer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rishilahoti","download_url":"https://codeload.github.com/rishilahoti/math-destroyer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rishilahoti%2Fmath-destroyer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278685675,"owners_count":26028322,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["framer-motion","gsap","javascript","nextjs","retro","tailwind","tailwindcss","typescript","web-game","webapp"],"created_at":"2025-08-17T15:01:42.610Z","updated_at":"2025-10-06T21:33:40.257Z","avatar_url":"https://github.com/rishilahoti.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Math Spaceship Game - Retro Arcade 🚀🔢\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat\u0026logo=typescript\u0026logoColor=white)\n![Next.js](https://img.shields.io/badge/Next.js-000000?style=flat\u0026logo=nextdotjs\u0026logoColor=white)\n\n**Blast your way to math mastery in this retro-style arcade game!** Combine fast-paced spaceship action with math challenges as you solve equations to defeat enemy ships. Perfect for students, gamers, and anyone looking to sharpen their math skills in a fun way.\n\n**[Play the Live Demo](https://math-destroyer.vercel.app/)**\n\n![Gameplay Video](https://github.com/user-attachments/assets/5420071f-a18e-419e-86a0-4306ece6a178)\n\n## 🎯 Core Idea\n\nA retro-style arcade game that combines fast-paced spaceship action with math challenges. Players control a spaceship and must shoot the correct answer to math problems displayed on enemy ships. The game blends education and entertainment, helping players improve their math skills while enjoying an engaging arcade experience.\n\n## 🚀 Key Features\n\n### Retro Arcade Aesthetic\n\n-   Pixel-style UI with glowing effects and chiptune sound effects\n-   Animated star backgrounds and spaceship animations\n-   CRT monitor-style visual effects for authentic retro feel\n\n### Math-Based Gameplay\n\n-   **3 difficulty levels**:\n    -   **Easy**: Addition \u0026 subtraction\n    -   **Medium**: Multiplication \u0026 division\n    -   **Hard**: Fractions \u0026 percentages\n-   Dynamic problem generation - new equations every round\n-   Progressive difficulty as you advance\n\n### Spaceship Combat Mechanics\n\n-   **Player controls**:\n    -   Move with **arrow keys (← →)** or **A/D keys**\n    -   Shoot with **Mouse click** or **tap (mobile)**\n-   **3 enemy ships per question**, each displaying a possible answer\n-   **Timer (10s per question)** and **3 lives** before game over\n-   Score multiplier for fast answers\n\n### Full Game Flow\n\n-   Home Screen → Level Selector → Gameplay → Win/Lose Screens\n-   High score tracking for each difficulty\n-   Performance feedback and tips\n\n### Responsive Design\n\n-   Works seamlessly on desktop \u0026 mobile\n-   Touch controls optimized for mobile players\n-   Adaptive UI for all screen sizes\n\n## 🎮 Why It's Unique\n\n-   **Learning through play**: Makes math practice fun and interactive\n-   **Retro nostalgia**: Mimics classic arcade games with modern web tech\n-   **Fast-paced \u0026 challenging**: Keeps players engaged with timed questions\n-   **Skill progression**: Gradually increases difficulty to match player ability\n-   **Accessible learning**: Helps build math confidence in a low-pressure environment\n\n## 🔧 Tech Stack\n\n-   **Frontend**: Next.js + TypeScript\n-   **Styling**: Tailwind CSS + custom animations + GSAP\n-   **Audio**: Howler.js for sound effects\n-   **Game Logic**: Pure TypeScript (no external engines)\n-   **Animation**: GSAP for smooth transitions and effects\n-   **Deployment**: Vercel\n\n## 🎯 Target Audience\n\n-   **Students (ages 8+)** looking for a fun way to practice math\n-   **Retro gamers** who enjoy arcade-style challenges\n-   **Educators/parents** seeking interactive learning tools\n-   **Anyone** wanting to improve mental math skills\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n-   Node.js (v18 or higher)\n-   npm (v9 or higher)\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/rishilahoti/math-destroyer\n\n# Navigate to the project directory\ncd math-destroyer\n\n# Install dependencies\nnpm install\n\n# Run the development server\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) in your browser to play!\n\n### Building for Production\n\n```bash\n# Build the application\nnpm run build\n\n# Start the production server\nnpm start\n```\n\n## 🕹️ How to Play\n\n1. **Choose your difficulty level** - Start with Easy if you're new!\n2. **Read the math equation** at the top of the screen\n3. **Move your spaceship** with arrow keys or A/D keys\n4. **Aim at the enemy ship** displaying the correct answer\n5. **Shoot** by clicking mouse or pressing spacebar/enter\n6. **Answer quickly** to earn bonus points!\n7. **Complete all 10 questions** without losing all lives to win!\n\n## 🤝 Contributing\n\nContributions are welcome! If you'd like to improve the game:\n\n1. Fork the repository\n2. Create a new branch (`git checkout -b feature/your-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin feature/your-feature`)\n5. Open a pull request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🌟 Support the Project\n\nIf you enjoy this game, please give it a ⭐ on GitHub!\n\n---\n\n**Play → Learn → Blast your way to math mastery!** 🚀🔢\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frishilahoti%2Fmath-destroyer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frishilahoti%2Fmath-destroyer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frishilahoti%2Fmath-destroyer/lists"}