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.

This is the beginning of the README. Read the rest at the original. Read the full README ↗