Publishing your game

Publishing is how your game gets a public URL that anyone can play. Until you publish, your game lives in your project workspace — visible to you and your collaborators only.

The publish badge

Every project's preview iframe has a Publish badge in the top-right of the toolbar. Its label shows the current state:

Click the badge to open the Publish modal.

What happens when you publish

The full round trip takes ~10–15 seconds depending on game size.

What your audience sees

Published games live at <Domain />/play/{gameId}. Anyone with the link can:

• Play the game directly in the browser (no sign-up gate).
• Like the game (signed-in only).
• Favorite the game (signed-in only).
• Comment (signed-in only) — single-level replies supported.
• Share via WhatsApp, X, Facebook, Reddit, Telegram, Email, or copy link. The share modal lives in the play page.
• See the author — your avatar + display name + link to your profile.
• See related games — the More Games sidebar shows games tagged similarly.

Fullscreen play

The play page's primary affordance is the screenshot gallery — clicking it opens fullscreen play (/play/{gameId}/fullscreen). On mobile, the auto-rotate behavior kicks in: a landscape game on a portrait phone rotates the canvas 90° via CSS so it fills the screen. On desktop, the canvas is letterboxed to the game's intrinsic aspect ratio.

If you want a direct-to-fullscreen URL (no play-page chrome), share /play/{gameId}/fullscreen directly. The share modal's copied URL points there by default.

Updating a published game

Any new agent turn (or Cmd+S) creates a new commit. The badge flips back to Ready to publish (amber) as soon as there are unpublished changes.

Click the badge → Publish again → the new version goes live, immediately replacing the previous one. Players hitting the URL get the new build within a few seconds (CDN cache).

There's no per-version URL — every player gets your latest published build. If you need version snapshots, file a support ticket and we'll discuss.

Unpublishing

There's no current "unpublish" toggle. To take a game offline:

• Delete the game. Settings → Project (in the editor's hamburger menu) → Delete. This removes the published URL and the project's data.
• Restrict to early access only. Currently not a built-in option; file a support ticket if you need this.

Game metadata

Beyond the build itself, your published page shows:

• Title + description — editable from the hamburger menu's Settings.
• Poster image — first published screenshot OR your custom upload. Auto-captured from the canvas on first publish; replace it from the hamburger menu's Settings.
• Tags — up to 10 freeform tags (#platformer, #pixelart). Tags drive the Browse-by-tag shelf on the home page and <Domain />/tags/X pages.
• Orientation badge — Portrait / Landscape, set at create time.

Tagging well

Tags are the main way players discover your game on the home page's Browse by tag row. Pick 3-8 tags that describe:

• Genre (platformer, puzzle, arcade)
• Visual style (pixelart, cartoon, minimal)
• Mechanics (coop, roguelike, racing)
• Length (short, endless)

Don't stuff irrelevant tags — moderation may remove off-topic tags from the public listing.

Embed your game

Each published game can be embedded on an external site via a simple iframe — useful for portfolio sites, dev blogs, and itch.io-style listings.

<iframe
  src="https://docs.umicat.ai/play/{gameId}/fullscreen"
  width="800"
  height="600"
  allowfullscreen
></iframe>

(Replace {gameId} with your game's actual id; the iframe will load the rotated / letterboxed fullscreen experience that adapts to the size you set.)

Removing your game from search / browse

Published games appear in the home page Discover grid and Browse by tag shelves automatically. If you want your game unlisted (only people with the direct URL can find it):

File a support ticket and we'll mark the game unlisted: true. We'll add this as a self-serve toggle when there's clear demand.

Next steps