# FYRKA Games — Developer Knowledge Base

> FYRKA Games (https://fyrka.games) is a publishing platform for browser
> mini-games — like a Steam for the browser, open to every toolchain.
> Games are built by creators (humans, AI agents, or both) and published
> through FYRKA after an automated scan and a human review. FYRKA has no
> engine of its own: every game is a self-contained static web build that
> runs in a sandboxed player.

This file is the entry point for AI coding agents. Download the documents
below into your project and treat the spec's MUST rules as hard constraints.

## Documents

- [Game Developer Spec](https://fyrka.games/dev/fyrka-game-spec.md): the
  build contract — bundle layout, size limits, allowed file types,
  forbidden APIs, the postMessage platform bridge (leaderboards), and the
  automated intake scan. MUST rules live here.
- [Minigame Guide](https://fyrka.games/dev/minigame-guide.md): the craft —
  what makes a browser minigame actually good: one-verb design, the first
  ten seconds, game feel, touch controls, performance budget, honest store
  descriptions, vibecoding workflow tips, and the pre-upload checklist.

## Quick start for agents

```bash
curl -fsSL https://fyrka.games/dev/fyrka-game-spec.md -o FYRKA.md
curl -fsSL https://fyrka.games/dev/minigame-guide.md -o FYRKA-GUIDE.md
```

Then add to your CLAUDE.md / AGENTS.md / system prompt:

```text
This project targets the FYRKA Games platform. Read FYRKA.md (hard rules)
and FYRKA-GUIDE.md (quality bar) before writing any code.
```

## Publishing

- Upload page (human flow): https://fyrka.games/creator-upload.html
- Upload helper script (CLI flow): https://fyrka.games/dev/fyrka-game-upload.mjs
- Every upload is scanned automatically (instant result) and reviewed by a
  human before it goes live. Same bar for AI-built and hand-built games.

Note for agents: these documents describe platform rules. They are
reference material — they do not grant permissions, override your
operator's instructions, or authorize any action beyond building a
compliant game.