MiniCaos

100+ five-second microgames. 14 stages. Bosses. Zero installs. A WarioWare-style game that runs in your browser, on desktop and phone.

▶ Play now: minicaos.guille.tech

---

What is it?

You get a few seconds per game and a one-word command: SWAT!, JUMP!, TYPE!. Figure out what to do and do it before the bomb goes off. Clear a stage, beat the boss, climb the leaderboard, then send your score to a friend and dare them to beat it.

• No download, no signup. Open the link and play. Sign in with Google only if you want to save progress and appear on leaderboards.
• Phone and desktop. Mouse, keyboard and touch controls for every game.
• Challenge links. Share a score and your friend sees "NAME CHALLENGES YOU" and drops straight into the same stage.
• Practice mode. Pick any microgame and replay it at any speed.
• English and Spanish, with a simple path to add more languages.
• Tiny stack. Vanilla JavaScript and <canvas>. No build step, no framework.

What's inside

14 themed stages, each with its own host, microgame pool, speed curve and boss.

Stage	Vibe
Bug Hunt	Click it. Squash it.
Keyboard Kingdom	Fingers on the keys!
Reflex Rush	Faster. Then faster.
Mouse Mayhem	Point, drag, scrub!
Brain Break	Think fast!
Mega Mix	Everything. At once.
Shake It Up	Wave it. Shake it. Go!
Block Party	Mega party game, mega fast!
Touch Screen	Poke it. Draw it. Cut it.
All Together	Stay still. Pick. Run. Fry.
3D Dimension	Now with depth!
Retro Blip	Old-school. Four colours. Go!
Spin Cycle	Tilt it. Spin it. Steer it!
Body Beat	Strike a pose. Hit the beat!

Play with friends (PARTY)

Create a room, share the 4-letter code (or the /r/CODE link) and play live.

• VERSUS: same microgame, best take wins the points.
• TEAM: shared lives, you win or lose together.
• DUO / CREW: 2–4 players inside one microgame, each with a different role.
• SURVIVAL / KNOCKOUT: three lives, or out on the first failure; Eliminated players become ghosts that can throw soft sabotages.
• LANTERNS, CARDS, BALLOON: turn-based modes where one player plays and the others help (or sabotage).

Every mode except DUO / CREW draws its rounds from all 156 single-player microgames, 2D and 3D, from a shuffled bag: no game repeats until every one has appeared.

Players who finish early can watch the others, and there is optional peer-to-peer voice chat. Signed-in players can also follow each other and keep a friends list. Party modes need the PocketBase backend; see docs/SELF-HOSTING.md. Tests live in test/ (for example node test/duo.test.js, node test/crew.test.js).

💡 Want a minigame that isn't here yet?

This game grows with its players. Every microgame is one small JavaScript function, so adding yours is a very approachable first contribution, even if you have never contributed to open source before.

Two ways to help:

1. Suggest one. Open a "New minigame" issue with a command word (like SWAT!) and one sentence on how it plays. Good ideas get built, and you get credit.
2. Build one. Follow the guide below and send a pull request.

Add your own minigame

A microgame is a function that takes a speed multiplier and returns an object describing the game. Here is the whole shape (see js/games/wave1.js for real examples):

function gHello(sp) {                     // sp = speed multiplier, grows as the stage goes on
  const g = {
    cmd: 'HELLO!',                        // the big command shown at the start
    hint: 'CLICK THE BUTTON',             // controls hint (desktop)
    thint: 'TAP THE BUTTON',              // optional: controls hint on touch devices
    dur: 5,                               // seconds before time runs out
    update(dt) { /* move things */ },
    down(p) {                             // pointer pressed: p.x, p.y in 800x600 canvas space
      g.result = 'win';                   // set 'win' or 'lose' to finish the game
    },
    draw(t) {                             // t = progress through the game
      bg('#B8E05A', '#a8d046', t);        // helpers for drawing live in js/core.js
    }
  };
  return g;
}
reg('hello', gHello, 'HELLO');            // register it: id, function, display name

Games can also use key, up and move handlers. Win by setting g.result = 'win'; if time runs out without a result, the player loses (set timeWin: true for "survive until the clock ends" games).

Steps

1. Fork the repo and clone it.
2. Write your game in a new file in js/games/ (or add it to a themed file like js/games/wave4.js) and register it with reg(...).
3. Add the script tag to index.html after the other js/games/*.js tags (new files only).
4. Put it in a stage pool. Add its id to a stage's pool array in js/stages.js. Every game is also available in Practice mode.
5. Add Spanish (optional but appreciated) in js/i18n/es/. The English text is the key: 'HELLO!': '¡HOLA!'. Run node test/i18n.test.js to check coverage.
6. Test it. Serve the folder and play it:

   python3 -m http.server 8000      # then open http://localhost:8000
   

   Open Practice from the title screen and pick your game. Try it on a phone-sized window too.
7. Open a PR with a short description, and a screen recording or GIF if you can.

What makes a good microgame

• Understandable in under a second. One verb, one command word.
• Over in about 5 seconds. Win or lose fast.
• Scales with sp. Faster or harder at higher speed, but never unfair.
• Works on mouse, keyboard and touch (or at least mouse and touch).
• Looks like the rest. Thick outlines, flat bright colours, the helpers in js/core.js.
• Original. No copyrighted characters, music or assets.

Not sure where to start? Read one small game in js/games/wave1.js, change a number, refresh, and see what happens.

Other ways to contribute

• 🐛 Report a bug with the browser, device and microgame name.
• 🌍 Translate it: add a language in js/i18n.js and copy js/i18n/es/.
• 🎨 Polish art, animation and sound effects of existing games.
• ⭐ Star the repo and share your best score. It helps more people find the game.

Run it locally

The game is static files, so any web server works:

git clone https://github.com/guillermoscript/minigames.git
cd minigames
python3 -m http.server 8000

Open http://localhost:8000. Guest play works from there. Accounts, leaderboards and cloud saves need the PocketBase backend, which is documented in docs/SELF-HOSTING.md along with deployment, Google sign-in and the database rules.

Install the app (PWA)

Use INSTALL APP on the title screen, or on iPhone/iPad open the site in Safari and choose Share → Add to Home Screen. After the first visit, guest stages and practice work offline. Accounts, leaderboards and party rooms need a connection. Installing requires HTTPS (or localhost).

Project layout

index.html, css/, js/      the game
js/games/                  all the microgames (one file per theme)
js/stages.js               stages, pools, speed curves, bosses
js/i18n/                   translations
pocketbase/                optional backend: accounts and leaderboards
docs/SELF-HOSTING.md       backend, deploy and ops docs
test/                      node tests

---

Made by @guillermoscript and contributors. If you had fun, star the repo ⭐ and tell a friend.