From 19a5d0f0938cf7c284022e7af6058e8e49e27a49 Mon Sep 17 00:00:00 2001
From: FragginWagon <greg.r.jacobs@gmail.com>
Date: Wed, 28 Jan 2026 19:00:08 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9A=20Update=20README=20with=20detaile?=
 =?UTF-8?q?d=20instructions=20for=20running=20the=20backend,=20using=20the?=
 =?UTF-8?q?=20Gamemaster=20API,=20and=20managing=20API=20keys?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 code/websites/pokedex.online/README.md | 36 +++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/code/websites/pokedex.online/README.md b/code/websites/pokedex.online/README.md
index 139fb6b..d2949a9 100644
--- a/code/websites/pokedex.online/README.md
+++ b/code/websites/pokedex.online/README.md
@@ -44,12 +44,46 @@ A modern Vue 3 web application for Pokemon Professors to manage tournaments, pro
 # Install dependencies
 npm install
 
-# Start development server (API key can be set via UI now!)
+# Start development server WITH backend API:
+npm run dev:full
+
+# Or start just the frontend (no backend):
 npm run dev
 
 # Open browser to http://localhost:5173
 ```
 
+**Backend Server**: When running `npm run dev:full`, the OAuth proxy and Gamemaster API start automatically on port 3001.
+
+### Gamemaster API
+
+The Gamemaster API provides access to Pokemon GO gamemaster data from PokeMiners:
+
+```javascript
+import { gamemasterClient } from './gamemaster-client.js';
+
+// Get filtered pokemon (base forms + regional variants)
+const pokemon = await gamemasterClient.getPokemon();
+
+// Get all forms including costumes and variants
+const allForms = await gamemasterClient.getAllForms();
+
+// Get all moves
+const moves = await gamemasterClient.getMoves();
+
+// Check what's available
+const status = await gamemasterClient.getStatus();
+```
+
+**Workflow**:
+1. Open the **Gamemaster Manager** at `/gamemaster`
+2. Click "Fetch from PokeMiners" to download latest data
+3. Click "Process & Break Up Data" to categorize
+4. Click "Save All Files to Server" to make available to all apps
+5. Other apps can now access via the GamemasterClient
+
+See [GAMEMASTER_API.md](GAMEMASTER_API.md) for full documentation and examples.
+
 **API Key Setup** (two options):
 1. **Option 1: UI-based (Recommended)** - Use the API Key Manager tool at `/api-key-manager` to store your key locally in the browser
 2. **Option 2: Environment-based** - Create `.env` file (see Environment Setup section below) for CI/CD or shared development