Zed on FreeGameStore

Build a free game using Zed. The agent reads the platform's SKILLS.md and knows the brand rules, the CLI, and the deploy flow before it writes a line of code.

Before you start: install Node 22+ and the FreeGameStore CLI.

npm i -g @freegamestore/cli fgs login

Set up Zed

Install Zed
Download from zed.dev. Available for macOS and Linux. Sign in to enable AI.
Scaffold the game
fgs init my-game --template canvas zed my-game
Add platform context to .rules
Zed reads .rules at the project root for assistant context:

cat > .rules <<'EOF' # Platform: FreeGameStore See https://freegamestore.online/skills.md for the canonical guide. Constraints: - Manrope + Fraunces only — no custom display fonts. - Brand CSS tokens (var(--accent), var(--ink), var(--paper)) — don't redefine. - Zero tracking SDKs. - Use the Shell component for layout. - Push to main = auto-deploy. EOF
Open the assistant panel (Cmd-?)
Pick a model in the dropdown — Claude Sonnet handles the platform's TypeScript + React idioms well.

Prompt the build

Build a Pomodoro timer game: 25-minute work, 5-minute break, configurable. Audio chime on phase change (Web Audio API, no audio files). Persist current session in localStorage.

Refactor the timer hook in my stopwatch game to use a Web Worker so the tick stays accurate when the tab is backgrounded.

Iterate

Run the dev server
cd my-game && pnpm install && pnpm dev

The agent will tell you which file it edited; refresh the browser to see the change.
Run compliance checks
fgs check

Catches missing brand fonts, tracking SDKs, oversized bundles, and missing PWA manifest before publish.
Publish
fgs publish --store games

Provisions github.com/freegamestore-online/my-game, the Cloudflare Pages project, the DNS record, custom subdomain at my-game.freegamestore.online, and the storefront entry — atomically.
Push your code
git push upstream main

Auto-deploys via Cloudflare Pages in ~30 seconds. Future commits to main deploy automatically.

What the AI knows (and doesn't ask you for)

Once SKILLS.md is loaded, the agent will:

Use the platform's CSS tokens (--accent, --ink, --paper, …) — never redefine them.
Use Manrope (body) + Fraunces (display) — never custom display fonts.
Refuse to add Google Analytics, Plausible, Mixpanel, or any tracker.
Use localStorage for persistence (or @freegamestore/games KV for connected games).
Push to main for deploy. Never wrangler pages deploy manually.
Never ask you for Cloudflare or GitHub tokens.

The compliance suite (fgs check) enforces all of the above on every push, so even if the AI slips, the platform catches it.

Get the source

The CLI, SDK, and compliance package live at https://github.com/freegamestore-online/platform. Reading the source is allowed — and often illuminating when you're trying to coax a difficult prompt.

Tips for Zed specifically

Cmd-? opens the assistant panel. Cmd-Enter sends a turn.
Use /file to attach a file to the chat. /diff shows the agent's pending edits.
Zed's multi-buffer view is good for diffing the agent's changes across files before accepting.
The model picker is at the bottom of the assistant panel — swap freely between Anthropic, OpenAI, and self-hosted.