# Ronark

> Ronark is a platform for web games: players play instantly in the browser at
> https://ronark.com, developers (and their AI agents) publish HTML5 games with
> one CLI command or a small HTTP API. Games run sandboxed on per-game origins;
> the platform provides accounts, identity tokens, cloud saves, multiplayer
> (relay rooms or authoritative server scripts), and durable game storage with
> leaderboards via a tiny in-game SDK.

Everything an agent needs to publish a game end-to-end is in one file:

- [Complete developer & agent guide](https://ronark.com/llms-full.txt): auth,
  CLI, full HTTP API reference, game manifest schema, in-game SDK, identity
  token verification, cloud saves, multiplayer, authoritative servers, data &
  leaderboards, CI recipes, limits and error codes.

Key facts:

- Auth: API key (`rk_live_…`) minted self-serve in the app (Studio — the card
  at the bottom of the right-hand panel) — sent as `Authorization: Bearer`.
- CLI: single-file, no install — `curl -fsSL https://ronark.com/cli/ronark.mjs
  -o ronark.mjs && node ronark.mjs` (Node 18+).
- Fast path: `init` → `create` → `deploy --promote` → `publish`. A game is
  live on https://ronark.com/g/{slug} in under a minute.
- In-game SDK: `<script src="https://ronark.com/sdk/v1.js"></script>` then
  `const ronark = await Ronark.init()` — player identity, signed JWTs
  (JWKS: https://ronark.com/.well-known/ronark-jwks.json), cloud saves,
  multiplayer rooms, leaderboard reads.
- Multiplayer: relay rooms free with zero server code; ship a `server.js` in
  the bundle for authoritative rooms (your logic on Ronark's servers, with
  timers/tick loops, replicated entities with built-in interpolation,
  durable storage, and crash recovery).
- Local dev: `ronark dev-token` makes localhost behave signed-in, including
  real multiplayer rooms. Logs: `ronark logs` or GET /v1/games/{slug}/logs.
- Complete sample game (manifest + authoritative server.js + client, the
  live Snake Arena): https://ronark.com/examples/snake-arena.txt
- Client-prediction reference (sendInput + shared step() + reconciliation,
  the live Netcode Lab): https://ronark.com/examples/netcode-lab.txt
- Human docs: https://ronark.com/docs (fetching it without an HTML Accept
  header returns llms-full.txt; /docs.md always does)