Play Minesweeper Online for Free

Play it here: mnswpr.com. This is the classic game Minesweeper built with vanilla web technologies (i.e., no framework dependency).

How to Play

The goal is to reveal every safe cell without detonating a mine. Your first click is always safe.

• Left click — reveal a cell
• Right click — flag / unflag a suspected mine
• Left + right click together (chording) — reveal the neighbors of a satisfied number
• Touch — tap to reveal, long-press to flag

Ways to Use

The web is a wonderful, free, and open platform to create and distribute value. You can use mnswpr in different ways:

• as a deployed web app
• as a library with npm i @ayo-run/mnswpr
• as a web component (coming soon).

Using it as a library takes only a few lines — mount it onto any element by id:

import '@ayo-run/mnswpr/mnswpr.css'
import mnswpr from '@ayo-run/mnswpr'

const game = new mnswpr('app')
game.initialize()

Tooling

The project has gone through years of existence. It started from 2019 when tooling was massively different. I have modernized it since and have witnessed how much easier and faster it is to build now - even without web frameworks or LLMs!

As of now the tooling I use are:

• Vite for bundling and development server
• Eslint for JS linting & CSS linting
• ESLint Stylistic for JS formatting
• Husky for git hooks
• PNPM for dependency & workspace management
• and a bunch of automation using scripts and Continuous Integration actions

Because a big part of this project's purpose is to track how the software development industry evolves — and because it has come a long way in modernizing along the way — I now also use it as a playground for coding agents. It's a small, framework-free, well-scoped codebase, which makes it a great sandbox to see how AI agents read, reason about, and change real code. To help them get their bearings quickly, the repo ships an AGENTS.md describing the architecture and conventions.

Development

Technology Stack: HTML, JS, and CSS; Google Firebase for leader board store; Netlify for hosting

To start development, you need node. I highly recommend pnpm to be used as well. Once you know you have this, you can do the following:

1. Install dependencies: pnpm i
2. Start the dev server: pnpm run dev

The rest of the everyday commands:

pnpm test        # run the Vitest suite
pnpm lint        # ESLint (JS + CSS)
pnpm lint:fix    # ESLint with autofix
pnpm build       # build the website
pnpm build:lib   # build the publishable library

Leaderboard (local Firestore emulator)

The leader board is backed by Google Firestore. For local development the app talks to the Firestore emulator by default — fully local, no cloud, no deploy. The flag VITE_FIRESTORE_EMULATOR=1 is already set in app/.env.development.

You need a JDK 21+ installed (the emulator runs on Java; firebase-tools itself is fetched on demand via npx). Then, in two terminals:

pnpm emulators      # terminal 1 — start the Firestore emulator on :8080 (+ UI)
pnpm seed:emulator  # terminal 2, once — fill it with sample scores
pnpm dev            # terminal 2 — run the app against the emulator

If the emulator isn't running, the board simply shows "unavailable" (a refused connection). To skip the emulator — for quick UI-only work, or if you don't have a JDK — set VITE_FIRESTORE_EMULATOR= (empty) in a local, gitignored app/.env.local; the app then uses the cloud mw-test namespace instead.

See docs/firebase-leaderboards.md for the full data model, security rules, environments, and deployment.

Contributing

Contributions are welcome! See AGENTS.md for the architecture, conventions, and release workflow before opening a pull request.

You just want to play?

👉 The live site is here: mnswpr.com

Background

One day, while working in my home office, I heard loud and fast mouse clicks coming from our bedroom. It's my wife, playing her favorite game (Minesweeper) on a crappy website full of advertisements.

I can't allow this, it's a security issue. 🤣

But it is also an opportunity.

I wanted to give her the same game, with a similar leader board she can dominate. And this is also a chance for me to dig deeper into vanilla JS.

Can I make a page with complex interactions (more on this later) without any library dependency?

What I have learned:

1. JS is awesome ✨
2. We don't always need JS frameworks (or TS) ✨
3. Even subtle UI changes can improve user gameplay experience ✨
4. There's more ways to break your app than you are initially aware of ✨
5. Competition motivates users to use your app more ✨
6. Hash in bundled filenames helps avoid issues with browser caching (when shipping versions fast) ✨

License

BSD-2-Clause

---

Just keep building.
A project by Ayo