rosebud publish

rosebud publish --directory <folder> [options]
rosebud publish --zip <file> [options]

Each publish creates a new game and saves its details to the state file. To change a game you already published, use rosebud update.

OptionsCopy Anchor Link

Use exactly one of --directory and --zip. See what you can upload.

ExampleCopy Anchor Link

rosebud publish --directory ./dist --title 'Moon Garden' \
  --description 'Collect five glowing seeds.'

Without a login, the result has a private claim link:

{
    "project_id": "6f1d2c8e-...",
    "play_url": "https://rosebud.ai/play/moon-garden",
    "claim_url": "https://rosebud.ai/claim#...",
    "claim_expires_at": "2026-10-27T19:04:11Z",
    "content_version": "9f2c41e0b7...",
    "state_file": ".rosebud/project.json",
    "next_action": "Claim by 2026-10-27T19:04:11Z to keep this game online for free. ..."
}

With an active rosebud login, the game goes straight into the account. The result has claimed: true, the owner and an editor_url instead of a claim link, and update works at once. If Rosebud couldn't add the game to the account, the result has the claim fields instead.

NotesCopy Anchor Link

• Unclaimed games are deleted one hour after upload. See Claim your game.
• If the result is unknown (exit 4), the game may already exist. Don't publish again right away. The same goes for an interrupted publish.
• A first publish refused with busy created nothing. Run it again after retry_after_seconds.
• A big game can take minutes, because each media file uploads on its own. Allow the time, or run the command in the background.
• If the state file already holds a game, publish stops with project_exists. Use update, or pass a new --state.
• If your login still waits for approval, publish stops with login_pending. Approve it, or run rosebud logout to publish with a claim link instead.