GUFGAMES

tiny browser games we make with Claude.
the rules below let your game live happily in the GufGames cabinet.

THE CONTRACT

• one folder, lowercase-kebab-case: games/<slug>/
• index.html — the game itself, self-contained
• game.json — title, emoji, description, made_by, date, screenshot
• screenshot.png — optional, ~400×400 (we render the emoji if missing)

RULES OF THE CABINET

• runs inside an iframe — don't try top.location, don't assume you own the tab
• self-contained: inline CSS/JS, or import from a CDN (esm.sh, unpkg) — no relative imports across folders
• React is fine via CDN as ESM, no build step needed
• pre-built bundles also fine — leave the dist/ in place with index.html as the entry
• prefix any localStorage keys with your slug (avoids collisions)
• no external network calls except CDN imports (honor system)

EXAMPLE game.json

{
  "title": "Space Guf",
  "emoji": "👾",
  "description": "Shoot the alien Gufs before they reach the bottom.",
  "made_by": "Dad",
  "date": "2026-04-30",
  "screenshot": "screenshot.png"
}

ASK CLAUDE LIKE THIS

Make a tiny browser game for GufGames called <NAME>.
Rules: single self-contained index.html, vanilla JS or React via
esm.sh, must work inside an iframe, no external assets. Keyboard or
touch controls. Show a clear start screen and a way to restart.
End with a score or an outcome. Also write game.json with
title/emoji/description/made_by/date/screenshot.

DEPLOYING

• on the VM: write the folder into ~/projects/GufGames/games/<slug>/
• from another machine: drop into \\<vm>\projects\GufGames\games\<slug>\
• or: install the deploy-to-gufgames skill and just say "deploy this to GufGames"