{"id":18290935,"url":"https://github.com/hichemtab-tech/minesweeper-js","last_synced_at":"2026-04-26T12:31:20.928Z","repository":{"id":246381184,"uuid":"812792800","full_name":"HichemTab-tech/MinesWeeper-js","owner":"HichemTab-tech","description":"**Minesweeper Game 🎮💣**  A fun and challenging Minesweeper game built with JavaScript! Uncover cells, avoid mines, and test your puzzle-solving skills. Created by HichemTab-tech. Contributions and suggestions are welcome! 🚀😊","archived":false,"fork":false,"pushed_at":"2024-06-27T15:03:59.000Z","size":559,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T07:43:20.057Z","etag":null,"topics":["game","game-2d","game-dev","game-development","gamedev","games","html-css-js","javascript","jquery","minesweeper","minesweeper-game","minesweeper-js","web"],"latest_commit_sha":null,"homepage":"https://hichemtab-tech.github.io/MinesWeeper-js/","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/HichemTab-tech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-09T22:16:44.000Z","updated_at":"2025-03-22T22:29:34.000Z","dependencies_parsed_at":"2024-06-27T18:08:08.591Z","dependency_job_id":null,"html_url":"https://github.com/HichemTab-tech/MinesWeeper-js","commit_stats":null,"previous_names":["hichemtab-tech/minesweeper-js"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/HichemTab-tech/MinesWeeper-js","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HichemTab-tech%2FMinesWeeper-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HichemTab-tech%2FMinesWeeper-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HichemTab-tech%2FMinesWeeper-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HichemTab-tech%2FMinesWeeper-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HichemTab-tech","download_url":"https://codeload.github.com/HichemTab-tech/MinesWeeper-js/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HichemTab-tech%2FMinesWeeper-js/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32297893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T09:34:17.070Z","status":"ssl_error","status_checked_at":"2026-04-26T09:34:00.993Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["game","game-2d","game-dev","game-development","gamedev","games","html-css-js","javascript","jquery","minesweeper","minesweeper-game","minesweeper-js","web"],"created_at":"2024-11-05T14:12:43.050Z","updated_at":"2026-04-26T12:31:20.893Z","avatar_url":"https://github.com/HichemTab-tech.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Minesweeper Game 🎉\n\nWelcome to the **Minesweeper Game**! 🚀 This is a classic Minesweeper game built with JavaScript, where you can test your puzzle-solving skills and try not to explode! 💣\n\n## How It Works 🛠️\n\nThe game board is a grid of cells, each of which may hide a mine (💣), a flag (🚩), or a number (🔢). The goal is to uncover all the cells without mines. Here’s how we’ve set it all up:\n\n### Game Board 🕹️\n\n- **Cells Creation**: We created a parent `\u003cdiv\u003e` and inserted lots of child `\u003cdiv\u003e`s representing the cells. Each cell contains:\n    - A mine element (💣)\n    - A flag element (🚩)\n    - A number element (🔢)\n\n- **Visibility**: These elements show or hide depending on the map details, revealing what's underneath the cell when clicked.\n\n### Game Settings ⚙️\n\n- **Size**: The number of cells is based on the selected size:\n    - **Extra Small**: 9x16 grid\n    - **Small**: 16x16 grid\n    - **Medium**: 32x16 grid\n    - **Large**: 48x64 grid _(not applicable yet because of performance issues)_\n    - **Extra Large**: 100x100 grid _(not applicable yet because of performance issues)_\n\n- **Difficulty**: The density of mines per size depends on the difficulty level:\n    - **Easy**: 10% of cells contain mines 🌟\n    - **Medium**: 20% of cells contain mines 💪\n    - **Hard**: 40% of cells contain mines 😱\n    - **Impossible**: 60% of cells contain mines 🔥\n\n### Uncovering Cells 🔍\n\nWe’ve implemented the **Flood Fill Algorithm** to determine which squares to uncover when a square is clicked. Here’s how it works:\n\n1. **Initial Click**: When you click on a cell, if it has no neighboring mines (number = 0), the algorithm will start uncovering all adjacent cells recursively until it reaches cells with numbers.\n2. **Recursive Uncovering**: This ensures that large empty areas are uncovered quickly and efficiently, making the game smoother and more exciting!\n\n### Additional Features 🎨\n\n- **Flag Mode**: Toggle between uncovering cells and placing flags with a simple click! This helps you mark potential mines and avoid explosions.\n- **Timer**: A ticking clock to keep you on your toes! ⏱️ We used the **[TickWatch](https://github.com/HichemTab-tech/TickWatch-js)** library by **[HichemTab-tech](https://github.com/HichemTab-tech)** to implement the timer.\n\n### Contributions and Suggestions 💡\n\nWe’re always open to contributions and suggestions! If you have any ideas to improve the game or if you want to contribute to the project, feel free to reach out or create a pull request. Let's make this game even more fun together! 🎉\n\n\n## Enjoy the Game! 🎮\n\nWe hope you have a blast playing our Minesweeper game! It's designed to be challenging and fun. So, go ahead and see if you can uncover all the cells without hitting a mine. Good luck, and happy sweeping! 🧹💣\n\nCreated with ❤️ by **[HichemTab-tech](https://github.com/HichemTab-tech)**.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhichemtab-tech%2Fminesweeper-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhichemtab-tech%2Fminesweeper-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhichemtab-tech%2Fminesweeper-js/lists"}