Opening Edge

iPhone-first PWA dashboard (100dvh, no page scroll). 25 weapons on one Your Weapons home in four racks (White Gambits, White Systems, Black Gambits, Black Systems). Square widget tiles; full details live in Learn. Each weapon is a short book line plus opponent branches. Under the board, the note is the written coach comment for that move. The board opens with no sign-in. Analyze runs Stockfish 17.1 on the device.

Production: https://blitzbar.app (Vercel project ply-chess, GitHub EmmanuelXK/ply-chess).

Handoff for the next person or agent: PROJECT_NOTES.md.

Repertoire

Home is four racks on one page. Rack membership lives in src/lib/openings/racks.ts; tile copy lives in src/lib/openings/specs.ts. Tiles are square marks with the name in regular sans underneath and a quiet Gambit or System caption. Phone vs iPad Air uses the auto size arranger.

White Gambits: Evans Gambit, Scotch Gambit, Vienna Gambit, Smith-Morra.

White Systems: London, Jobava London, French KIA, Caro-Kann Fantasy, Grand Prix, Alapin, English, Queen's Gambit.

Black Gambits: Benko, Budapest.

Black Systems: Caro-Kann, Black Lion, Pirc, Sicilian Dragon, Scandinavian, Alekhine, King's Indian, Modern Benoni, Dutch Leningrad, Slav, Carr Defence.

King's Gambit is not on the grid. The Max Lange Attack is a Scotch Gambit branch, not its own tile.

Home is Learn: one move at a time, then Analyze. Kind, vs-line, time, and traps live in Learn.

Move note

Learn keeps a fixed strip under the board so the board does not jump. It shows the current move in SAN and, when the book has a coach note for that exact SAN, the note. Quiet plies stay SAN-only. There is no generated move description. At a fork, chips show the opponent's alternatives. When the line ends, the strip says book ends.

Branches live in those chips and in the drill menu.

Engines

Learn shows the stored Stockfish 17.1 depth-22 book eval immediately. Live search is Stockfish only: about 2.5 seconds or depth 20, and the depth reached sits beside the bar. A bar with no score yet is a loading state.

Engine	Role	What ships
Stockfish 17.1 lite	Multithreaded WASM when the page is cross-origin isolated	public/engines/stockfish-17.1-lite.{js,wasm} (~6.8 MB). The worker loads the wasm by swapping .js for .wasm. GPL-3.0.

Notices and the GPL text live in public/engines/NOTICE.md. Lc0 and Fairy-Stockfish are not included.

Back / Forward

Large Back and Forward under the board (thumb zone). Instant ply-by-ply through the spine — hurry the repertoire. Same control set inside Analyze. Chessground animations ~90ms (no teleports).

Analyze

Analyze on the dock, or long-press the board, from Learn opens a full-screen board at /analyze. The book line is the mainline and the cursor starts on the current Learn move. Stockfish 17.1 searches until you stop it, or to a chosen depth and time, with three lines, a best-move arrow, and a slim eval bar. Free moves branch the move tree (jump, delete, promote). The ECO name follows the position. PGN and FEN paste and copy live on that page. Learn still uses only the short on-device Stockfish search.

History Gig Pack

The old history marks were written for the 21-move spines. They are not attached to the new book lines, so nothing mismatched appears on the move strip. The pack file is still in the repo.

Data: src/lib/openings/history.ts. Typed HistoryMilestone (plyOrFen, era, glyph, sources, optional famousGame). Validation requires ≥1 sourced milestone per system and https URLs. No folklore — if Wikipedia does not support a game/year, it is not in the pack. Romantic gambits (King’s Gambit, Evans) carry extra marks (Immortal, Evergreen, Kasparov revival). The Black Lion cites Dutch club pages (Jansen–den Ouden, 14 Jan 1967) plus Chess.com book notes, because it has no Wikipedia article.

Add a milestone

1. Confirm the fact on Wikipedia (preferred) or another primary page.
2. Append an object in HISTORY_PACK with openingId, plyOrFen (ply count after the key move, or a FEN), title, year, era, summary (2–4 sentences), whyItMattersHere, sources: [{ label, url }], glyph.
3. Optional famousGame and trapId (trap-only marks).
4. npm run validate — fake URLs and empty sources fail the build.

Run

npm install
npm run dev

App: http://127.0.0.1:43173

npm run validate   # 25 weapons, legal lines, ECO names, stored evals, coach notes
npm run build

On an iPhone: open the URL in Safari, Share → Add to Home Screen. Settings repeats those steps. Android and Chrome can use Install app. The service worker is network-first for pages and does not intercept /engines/, so Stockfish keeps cross-origin isolation.

Add a system

1. Add the weapon and its lines to src/lib/openings/data/weapons-v2.json (moves, evals, ECO, notes).
2. Add a matching ECO row to src/lib/openings/data/eco-subset.json when the line needs a new name.
3. Add a spec in src/lib/openings/specs.ts for the tile copy. Spec id must match the book.
4. Add that id to the right rack sequence in src/lib/openings/racks.ts.
5. Add a square mark id in src/lib/openings/mark-ids.ts and a glyph in weapon-mark.tsx.

Inspired by Lotus / Chessreps ideas — no copied code, assets, or branding.

Sync note

This repo is GitHub EmmanuelXK/ply-chess (what production ply-chess / blitzbar.app should track). If an Origin grokmee/opening-edge tree still exists, merge this branch there or point Vercel at this GitHub remote so the 26-system professor pack is what deploys.