Welcome to Minesweeper Alliance, an open-multiplayer riff on the classic Minesweeper game. Join forces with your fellow allies to sweep mines in real-time!
Ruby version: 3.3.5+
To get started:
bin/setupbin/devIf more control over the server processes is needed they can be run without foreman.
e.g. To simplify breakpoints/debugging, run the Rails server in its own process:
bin/rails server --port=3000
# Or, to allow for testing via other browsers on local network:
bin/rails server --binding 0.0.0.0 --port=3000... then run the tailwindcss server in a separate tab/process:
bin/rails tailwindcss:watchUse debug mode to show mines placement on the Game board, and to enable additional logging, etc. Search on App.debug?.
DEBUG=1 bin/rails server [...]Use dev mode to disable mine density validations, ... Search on App.dev_mode?.
DEV_MODE=1 bin/rails server [...]To temporarily disable Turbo:
DISABLE_TURBO=1 bin/rails server [...]- PostgreSQL
# Unit tests
bin/rake test
# System tests
bin/rake test:systemOr, run test, rubocop, reek, and test:system all at once:
bin/rake
Note: Much of the complexity in this app comes from the need for varying content based on current Game state. Especially given the "War Room" (home page) dynamically adjusts to current game state by:
- Showing the "New Game" content when no current Game exists,
- Showing the "Current Game" content when a current Game exists,
- Showing "Just Ended" Game content (to all participating Users) on Game end.
Plus, there are various ways of displaying past Games:
- Sweep Ops Archive
- Metrics
- User context
The overall structure of the view templates and View Models to support this looks like:
Current Game:
- Game status ("Standing By" vs "Sweep in Progress")
- Rules of Engagement
Just ended Game:
- Game "Title"
- Game status ("Mines Win" vs "Alliance Wins")
- "Signature" section for signing Username + <hr> above it
- Metrics + Duty Roster
Sweep Ops Archive: Standard view of past Games.
- Game "Title"
- Game status ("Mines Win" vs "Alliance Wins")
- Metrics + Duty Roster
Metrics -> Games:
- Game "Title"
- Metrics + Duty Roster
User -> Games:
- Game "Title"
- Metrics + Duty Roster
# Plus:
New Game:
- Standard: Beginner, Intermediate, or Expert
- Random (one of the Standard Games, plus a small chance for a random Pattern Game)
- Custom Game
View Models are POROs that:
- Insulate view templates from ActiveRecord Models,
- Handle view-specific logic ("display" versions of Model attributes, conditionals, etc.),
- Live alongside the view templates/partials they support, and
- Are easily unit testable (though there are currently very view View Model tests in this project).
View Models are somewhat similar to, yet much simpler than, GitHub's ViewComponent pattern/gem. They make no attempt to intervene in the rendering stack or to add a custom DSL. The only thing to learn about them is when to use them and, to some extent, how.
Generally speaking, a View Model should be used any time a view template would otherwise need to interact with the application layer or implement any kind of logic via ERB. View templates should still render their own HTML, but should appeal to View Models for any non-static view code.
Visiting the site for the first time automatically creates a new User entry in the database. The primary key for this entry is a UUID. The UUID is stored in an HTTP cookie for re-identification of the current User in the future. It is easily possible to create multiple User records per actual user (e.g. by visiting on different browsers or computers), but this is an acceptable price to pay versus the pain of explicitly registering a User + credentials for such a simple site. This is also reminiscent of arcade games: just enter your username after finishing a game and that's trustworthy enough.
At the end of any game that a user participates in, an option is presented for signing their username. This may be not only a point of pride, but it also unlocks additional functionality. e.g. custom game board sizing and the ability to permanently hide the welcome banner at the top of the War Room page.
The default Time Zone for this app is Central Time (US & Canada). However, JavaScript is used to detect the current user's local time. This is then used to set the current Time Zone for the duration of each request.
Visit /ui while in the development environment to access the UI Portal. This portal acts as a playground / test bed when developing new UI/UX features.
Currently a bit lumped into the UI Portal at /ui/patterns is the Patterns tool--for creating playable mine patterns. These boards/patterns are selected by random luck (as an Easter egg) when staring a new "Random" game.
Patterns my be imported/exported as CSV. The mere presence of a Pattern in the database makes it eligible for being randomly selected for game play.
First, push changes to GitHub:
git push origin mainNext, ... (TODO: No production server yet.)
Bug reports and pull requests are welcome on GitHub at https://github.com/pdobb/minesweeper_alliance. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.
The app is available as open source under the terms of the MIT License.
Everyone interacting in the Gemwork project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.