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.