{"id":20903022,"url":"https://github.com/recepsenoglu/minesweeper","last_synced_at":"2025-05-13T04:33:05.658Z","repository":{"id":168350853,"uuid":"603562418","full_name":"recepsenoglu/minesweeper","owner":"recepsenoglu","description":"A minesweeper game app built with Flutter","archived":false,"fork":false,"pushed_at":"2024-08-08T11:21:54.000Z","size":23189,"stargazers_count":9,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-18T13:18:44.841Z","etag":null,"topics":["flutter","flutter-games","minesweeper","minesweeper-game"],"latest_commit_sha":null,"homepage":"","language":"Dart","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/recepsenoglu.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":"2023-02-18T22:08:33.000Z","updated_at":"2024-11-13T05:44:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"984de8ed-8321-47fd-8b07-10d677ceb790","html_url":"https://github.com/recepsenoglu/minesweeper","commit_stats":null,"previous_names":["recepsenoglu/minesweeper"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/recepsenoglu%2Fminesweeper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/recepsenoglu%2Fminesweeper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/recepsenoglu%2Fminesweeper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/recepsenoglu%2Fminesweeper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/recepsenoglu","download_url":"https://codeload.github.com/recepsenoglu/minesweeper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253877265,"owners_count":21977632,"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":["flutter","flutter-games","minesweeper","minesweeper-game"],"created_at":"2024-11-18T13:01:17.130Z","updated_at":"2025-05-13T04:33:00.647Z","avatar_url":"https://github.com/recepsenoglu.png","language":"Dart","readme":"# Minesweeper Game App\n\nThis is a simple Minesweeper game app developed using Flutter/Dart technologies. It features 3 difficulty settings, sound effects, and a statistics page to keep track progress. The game is implemented using the Provider package for state management and developed with **MVC** (_Model-View-Controller_) software architecture.\n\n## Installation\n\nTo use this app, simply clone the project and run it in your preferred IDE. No additional installation is required.\n\n## Usage\n\nTo start a new game, click New game button and the game board will be generated automatically. You can choose a difficulty level for different sizes of game board and mine counts. To play, tap on any of the cells on the board to reveal what's underneath. If you reveal a bomb, the game is over. If you reveal a number, it indicates how many bombs are adjacent to that cell. Use this information to avoid the bombs and uncover the entire board to win the game.\n\nTo mark a cell that you think contains a mine, you can hold down on the cell to place or remove a flag. There are as many flags as mines in the game, and you can use them to keep track of where you think the mines are.\n\n## Features\n\n- 3 difficulty settings\n- Sound effects\n- Timer that starts when the game begins\n- Flags for marking cells that contain mines\n- Board size changes based on difficulty setting\n- Gameplay metrics tracking\n\n\n\n## Technologies Used\n\n- [**Flutter**](https://flutter.dev)\n- [**Dart**](https://dart.dev)\n- [**Provider**](https://pub.dev/packages/provider)  package for state management\n- [**just_audio**](https://pub.dev/packages/just_audio) package for playing sounds\n- [**shared_preferences**](https://pub.dev/packages/shared_preferences) package for saving high scores\n- [**google_fonts**](https://pub.dev/packages/google_fonts) package for font styles\n\n## Screenshots\nHomeView |Gameplay |Gameplay |Statistics\n:-:|:-:|:-:|:-:\n\u003cimg src=\"./screenshots/home.png\" width=300/\u003e | \u003cimg src=\"./screenshots/gameplay.png\" width=300/\u003e | \u003cimg src=\"./screenshots/lose_screen.png\" width=300/\u003e | \u003cimg src=\"./screenshots/statistics.png\" width=300/\u003e\n\n## Preview\n\nhttps://user-images.githubusercontent.com/83721234/227311414-8494b690-8cb6-4a28-9e3f-d068b2fd4f25.mp4\n\n## Roadmap\n\n- Add more sound effects and music options\n- Add the ability to customize game settings\n- Implement a leaderboard for tracking high scores\n\n## Contributing\n\nAs this project was made by only one person, there is no team to contribute to it. However, feel free to fork the project and make your own changes or improvements.\n\n## Credits\n\nCreated by [@recepsenoglu](https://github.com/recepsenoglu) - feel free to contact me!\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](https://github.com/recepsenoglu/minesweeper/blob/main/LICENSE) file for details.\n","funding_links":[],"categories":["Dart"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frecepsenoglu%2Fminesweeper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frecepsenoglu%2Fminesweeper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frecepsenoglu%2Fminesweeper/lists"}