Publish your game

If it runs in a browser tab from static files, it runs here. Any engine, any framework, hand-written or AI-assisted. You keep your own site; neme.world is one more place people can find and play it.

Starting from nothing? Copy the starter: a small game that already works here, with instructions for a coding agent beside it.

1. Get a token

Create an account and create an API token. Anyone can: there is no waiting list. Confirm your email address from the link we send you before you make your first game.

Your game is live at its own link the moment you publish it, ready to share. It joins the home page and search once we have looked at your first game, usually within a few days; your later games appear at once.

2. Describe the game

Add a neme.json next to your project (or run npx neme-world init):

{
  "slug": "my-game",
  "title": "My Game",
  "description": "One or two sentences players will see.",
  "tags": ["arcade"],
  "dir": "dist",
  "cover": "cover.png",
  "controls": ["keyboard", "mouse", "touch"],
  "leaderboard": { "max": 5000 }
}

dir is the folder holding your built index.html. cover is an image inside it; leave it out and we take a screenshot for you. controls lists what the game can be played with (keyboard, mouse, touch, gamepad): players on a device that doesn't fit are told before they start, and phones list touch games first.

leaderboard is optional. With it, the scores your game reports through the SDK are ranked on its page: the best hundred, each under a made-up name the player is given (nobody types one, and no account is needed). max is the highest score a player could really reach; anything above it is ignored. A game runs in the player's browser, so a score cannot be verified and the board says so. You can remove an entry from the board on your game's page, or empty it from your dashboard. Leave leaderboard out, or set it to null, for no board.

To show the game on your own website as well, add "embedOn": ["example.com"] with your site's host names. Your dashboard then gives you an <iframe> to paste. Only the sites you name can embed the game, and plays there are counted in the same dashboard.

3. Publish

export NEME_TOKEN=neme_…
npx neme-world publish

Every publish is a new immutable version, served from a cache-forever URL, and you can roll back to any earlier version from the dashboard in one click. Hidden files and node_modules are never uploaded.

Not ready for players? npx neme-world publish --preview uploads the build without making it live and gives you a link to try it and share it. npx neme-world promote 7 makes version 7 live.

Prefer not to use the command line? Upload a zip from your dashboard instead. In CI, run the same command with NEME_TOKEN set as a secret. Something not working? Tell us; the command's source is there too.

Building with a coding agent? Point it at https://neme.world/llms.txt: everything a game needs to work here, on one page. Or give it the same commands as tools, by adding npx -y neme-world mcp to its MCP servers with NEME_TOKEN set. It uploads a preview, hands you the link, and makes a version live only when you say so.

4. Optional: talk to the player

Include the SDK to report load time, scores and your own events to your dashboard. It does nothing when your game runs anywhere else, so one build works everywhere.

<script src="/_neme/sdk.js"></script>
<script>
  window.neme?.ready()                 // the game is interactive
  window.neme?.score(1280)             // a finished run
  window.neme?.event('level_complete', 3)
  shareButton.onclick = () => window.neme?.share()   // "share my score"
</script>

Once a game reports a score, the page's Share button shares it: the link carries the player's best score of that visit, and whoever opens it is shown the score to beat. neme.share() opens the same share sheet from a button of your own, such as one on your game-over screen. Nothing is stored; the score travels in the link.

If your game draws on a <canvas>, including the SDK also gives players a Record clip button: up to thirty seconds of the game is recorded in the player's own browser and shown to them with a Share button. Nothing is uploaded, and sound is not recorded. neme.clip.start() and neme.clip.stop() do the same from a button of your own.

What you can measure

Page views, plays, time played, load time, shares, and how many visits came back through shared links. No cookies are set on players.

HTTP API

PUT  https://neme.world/api/v1/games/:slug              create or update details (JSON)
POST https://neme.world/api/v1/games/:slug/versions     upload a zip (body: application/zip)
POST https://neme.world/api/v1/games/:slug/activate     {"version": 3} to roll back, null to unpublish
GET  https://neme.world/api/v1/games/:slug/metrics      the numbers behind your dashboard
GET  https://neme.world/api/v1/games                    the public catalog

Authenticate with Authorization: Bearer $NEME_TOKEN.