{"id":25835794,"url":"https://github.com/hasanulmukit/maze-quest-nextjs","last_synced_at":"2025-10-18T20:14:40.975Z","repository":{"id":277087113,"uuid":"931292506","full_name":"hasanulmukit/maze-quest-nextjs","owner":"hasanulmukit","description":"Maze Quest is a modern, interactive maze game built with Next.js, Tailwind CSS, and the Canvas API.","archived":false,"fork":false,"pushed_at":"2025-02-12T03:08:19.000Z","size":66,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-01T01:34:17.241Z","etag":null,"topics":["canvas","maze-solver","nextjs","tailwindcss","webgame"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/hasanulmukit.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}},"created_at":"2025-02-12T03:05:57.000Z","updated_at":"2025-02-14T06:47:09.000Z","dependencies_parsed_at":"2025-02-12T04:23:35.796Z","dependency_job_id":"c73e0b7c-c5f0-42ed-834c-80d69152dfcc","html_url":"https://github.com/hasanulmukit/maze-quest-nextjs","commit_stats":null,"previous_names":["hasanulmukit/maze-quest-game","hasanulmukit/maze-quest-nextjs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasanulmukit%2Fmaze-quest-nextjs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasanulmukit%2Fmaze-quest-nextjs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasanulmukit%2Fmaze-quest-nextjs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasanulmukit%2Fmaze-quest-nextjs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hasanulmukit","download_url":"https://codeload.github.com/hasanulmukit/maze-quest-nextjs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241304308,"owners_count":19941100,"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","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":["canvas","maze-solver","nextjs","tailwindcss","webgame"],"created_at":"2025-03-01T01:34:27.715Z","updated_at":"2025-10-18T20:14:40.965Z","avatar_url":"https://github.com/hasanulmukit.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Maze Quest\n\n**Maze Quest** is a modern, interactive maze game built with Next.js, Tailwind CSS, and the HTML5 Canvas API. The game features smooth player transitions, enhanced maze rendering with gradients and grid lines, and a dynamic fog-of-war effect that simulates limited visibility. Navigate the labyrinth using your arrow keys and guide your hero to the exit for an immersive gaming experience.\n\n## Table of Contents\n\n- [Features](#features)\n- [Getting Started](#getting-started)\n- [Project Structure](#project-structure)\n- [Technologies Used](#technologies-used)\n- [Future Enhancements](#future-enhancements)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Features\n\n- **Maze Generation:**  \n  Uses a recursive backtracking algorithm to generate challenging mazes.\n- **Smooth Player Transitions:**  \n  The hero smoothly glides between maze cells via animated interpolation.\n- **Enhanced Maze Rendering:**  \n  Maze walls feature a vertical gradient with subtle grid lines for added depth.\n- **Dynamic Lighting (Fog-of-War):**  \n  Only a portion of the maze around the hero is visible, creating tension and a sense of exploration.\n- **Responsive UI:**  \n  The interface is styled using Tailwind CSS to ensure a consistent experience across devices.\n- **Manual Navigation:**  \n  Move your hero using the arrow keys. Reach the green exit cell to win!\n\n## Getting Started\n\n### Prerequisites\n\n- **Node.js** v16 or later\n- **npm** (Node Package Manager)\n\n### Installation\n\n1. **Clone the repository:**\n\n   ```bash\n   git clone https://github.com/yourusername/maze-quest.git\n   cd maze-quest\n   ```\n\n2. Install dependencies:\n\n   ```bash\n   npm install\n   ```\n\n3. Run the development server:\n\n   ```bash\n   npm run dev\n   ```\n\n4. Open your browser and navigate to http://localhost:3000 to start playing.\n\n## Project Structure\n\n- maze-quest/\n- ├── app/\n- │ ├── layout.jsx // Root layout with global CSS import\n- │ ├── globals.css // Global Tailwind CSS styles\n- │ ├── page.jsx // Homepage\n- │ └── maze/\n- │ └── page.jsx // Maze game page (manual navigation, animations, fog-of-war)\n- ├── lib/\n- │ └── maze.js // Maze generation and solving logic\n- ├── tailwind.config.js // Tailwind CSS configuration\n- ├── postcss.config.js // PostCSS configuration\n- ├── package.json\n- └── README.md\n\n## Technologies Used\n\n1. Next.js (App Router)\n2. React\n3. Tailwind CSS\n4. HTML5 Canvas API\n5. JavaScript\n\n### Future Enhancements\n\n- Sound Effects and Music:\n  Integrate audio for player actions and background ambiance.\n- Scoring System:\n  Add a timer or move counter to track performance.\n- Multiple Levels:\n  Introduce mazes of increasing difficulty and new obstacles.\n- Touch Controls:\n  Implement swipe gestures for mobile navigation.\n- Multiplayer or Leaderboard:\n  Use a backend service or Firebase to enable high scores and competitive play.\n\n### Contributing\n\nContributions are welcome! Feel free to open issues or submit pull requests. Please follow the standard GitHub workflow for contributing to open-source projects.\n\n## #License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasanulmukit%2Fmaze-quest-nextjs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhasanulmukit%2Fmaze-quest-nextjs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasanulmukit%2Fmaze-quest-nextjs/lists"}