GitHub Copilot on FreeGameStore

Build a free game using GitHub Copilot. 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 Copilot in VS Code

  1. Install GitHub Copilot + Copilot Chat extensions

    Open VS Code → Extensions → search "GitHub Copilot" and install both. Sign in with your GitHub account.

  2. Scaffold the game
    fgs init my-game --template canvas code my-game
  3. Add platform context to .github/copilot-instructions.md
    mkdir -p .github && cat > .github/copilot-instructions.md <<'EOF' # Platform: FreeGameStore Always follow the conventions in https://freegamestore.online/skills.md. When editing files in this repo: - Use Manrope (body) + Fraunces (display) — no custom display fonts. - Use brand CSS tokens: var(--accent), var(--ink), var(--paper). Don't redefine them. - Never add Google Analytics, Plausible, Mixpanel, or any tracking SDK. - Use the existing Shell component for layout. - Push to main triggers auto-deploy; no manual deploy commands. EOF

    Copilot reads .github/copilot-instructions.md automatically and prepends it to every chat turn.

  4. Open Copilot Chat (Ctrl-Cmd-I)

    Start prompting. Use @workspace in chat to give the agent broader context.

Prompt the build

@workspace Build a unit-converter game with a left-side category picker (length, weight, temperature, …) and right-side input/output. Persist the last unit pair per category. Use the Shell layout.
@workspace Add export-to-CSV to the laps list in my stopwatch game. Open a Save dialog with the current date in the filename.

Iterate

  1. 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.

  2. Run compliance checks
    fgs check

    Catches missing brand fonts, tracking SDKs, oversized bundles, and missing PWA manifest before publish.

  3. 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.

  4. 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:

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 Copilot specifically