Connect your Claude

Robot Recess gives Claude ready-made instructions. In Claude Code they are slash commands (also in the / menu as /robot-recess:…); in claude.ai, just say what you want, like Join Robot Recess workshop abc123.

• A single self-contained HTML file, or a zip of static files with index.html at the root. Max 5 MB (Premium 25 MB) and 300 files.
• Static files only: HTML, JS, CSS, JSON, images, audio, video, fonts, WebAssembly, 3D models. No server code.
• No calls to other websites: fetch, WebSocket and external images or stylesheets are blocked. Put every asset in the upload.
• Classic <script src> tags from cdnjs, jsDelivr or unpkg and Google Fonts links are downloaded and bundled for you. ES-module imports from CDNs are not: include those files.
• Games run in a sandboxed iframe on their own origin. localStorage and Web Workers keep working; a service worker gets a harmless stand-in (no offline caching) and IndexedDB is not available (use localStorage or RR.save); alert() shows a toast; confirm() and prompt() do nothing.
• Include a <title> and a viewport meta tag, load in under 3 seconds, and support keyboard and mouse (touch too if you can).
• Fit the frame: about 830x464 to 1198x674 on the game page, 1232x628 in Big Screen, 390x844 or 844x390 on phones. Choose the layout from RR.layout (or by height and input type), keep text readable at 830x464, and check it with fit-check.mjs before you publish.
• Tell the portal how your game fits: fit "fill" when it resizes itself to any box (else "letterbox" keeps its shape with bars), min_size when its layout breaks in small windows (the portal scales it down instead), orientation for phones, and input (keyboard, mouse, touch, gamepad). Big games set fit fill, opens_big and a min_size.
• All-ages and original: no real brands or copyrighted characters. No ads inside games.

Categories: action (Action), shooting (Shooting), puzzle (Puzzle), sports (Sports), racing (Racing), multiplayer (Multiplayer), strategy (Strategy & Sim), weird (Weird).

Free: 5 MB per game. Premium: 25 MB. Checks run on every upload; a game that fails is sent back with a report that says how to fix each problem.

Every game gets window.RR injected automatically: no script tag needed.

// window.RR is injected into every game. Guard calls so the game also runs elsewhere.
window.RR && RR.gameOver(score);         // a run ended: the score saves quietly (a toast, no dialog); call it at every natural end
window.RR && RR.submitScore(score);      // a new best mid-run (e.g. at a day's end), also quiet; the board keeps each player's best
window.RR && RR.unlock('first_win', 'First Win!');   // achievement toast (saved on this device when logged out)
await RR.save({ level: 3 }, 'slot1');   // cloud save when signed in, local otherwise
const data = await RR.load('slot1');    // -> your data or null
RR.on('pause', () => paused = true);    // portal dialogs pause the game: stop the clock
RR.on('resume', () => paused = false);
RR.integrations.supabase                // Premium: { url, anonKey } of a connected Supabase project
RR.layout                               // { mode, width, height, scale, dpr, input: 'touch'|'mouse' } or null (SDK 1.2)
RR.on('layout', (l) => relayout(l));    // the box changed (Big Screen, full screen, phone turned)
// Fit the frame: about 830x464 on the page, 1232x628 in Big Screen, 390x844 / 844x390 on phones.
// Pick the layout by height and input type, never by width alone (RR.layout has both). Leave fullscreen and Esc to the portal.
// Big games publish with fit: fill, opens_big and a min_size (e.g. 1000x620): the portal scales the game down instead of squeezing it.

Fit the frame, keep score

Your game is shown in a box of about 830×464 on the game page, 1232×628 in Big Screen and 390×844 or 844×390 on phones. Pick your layout from RR.layout (or by height and input), never by width alone. Big games set fit: "fill", opens_big and a min_size (like "1000x620") so the portal scales them down instead of squeezing them, and every game lists its input (keyboard, mouse, touch, gamepad). Call RR.gameOver(score) at every natural end and RR.unlock for achievements: a game without them gets no high-score board. Before you publish, download fit-check.mjs (one file, Node 22 or newer, nothing to install): it screenshots your build at each size so you, or your AI, can spot anything cut off or too small.

curl -fsSLO https://robotrecess.com/static/fit-check.mjs
node fit-check.mjs --dir ./dist

Premium creators can connect a Supabase project (publishable key only, Row Level Security on) or a custom https backend. Pass it when publishing, or later with update_game:

{
  "integrations": {
    "supabase": {
      "url": "https://<project-ref>.supabase.co",
      "anon_key": "sb_publishable_..."
    }
  }
}

The game reads the config from RR.integrations.supabase ({ url, anonKey }). Secret and service_role keys are always refused. What Premium includes.

Have a build folder (Vite, Phaser, plain files)? Download rr-publish.mjs, a zero-dependency publisher in a single file (Node 22 or newer, nothing to install). It zips the folder, skips dotfiles and node_modules, and publishes through this same MCP server with a personal token.

# once: download the publisher (a single file, no installs)
curl -fsSLO https://robotrecess.com/static/rr-publish.mjs
export RR_TOKEN=rr_YOUR_TOKEN
node rr-publish.mjs --dir ./dist --base https://robotrecess.com \
  --title "Bolt Dash" --category action --description "Dash through the hallway before the bell." \
  --instructions "Arrow keys to run, space to jump." --made-with claude --aspect 16:9 --input keyboard,mouse,touch

# later: ship a new version of the same game
node rr-publish.mjs --dir ./dist --base https://robotrecess.com --update bolt-dash --notes "Fixed the jump bug"

Run node rr-publish.mjs --help for every option (jam entry, score order, Supabase, custom backends).