BfBHelper
A companion web app for players of Battle for Biternia, a physical
tabletop board game. The goal: a group should be able to play a full game
with just the physical cards. Everything else (draft order, HP/level, gold,
structures, positions on the board, initiative, tokens) is tracked by this
app.
Live at https://bf-b-helper.vercel.app/. Current version: see
"version" in frontend/package.json.
Features
All features target the 2-player game on a single shared device; state
persists across reloads via localStorage, no backend needed. Since
v1.0.0 every hero's tokens and abilities are tracked, so a game can be
played with only the physical cards.
| Area | Intents | Shipped |
|---|
| Draft: the official 2-player draft order after a coin flip for initiative, ending on a versus entrance. | 01, 10 | v0.1.0, v0.10.0 |
| Battle Board and Controls: both teams side by side with heroes, Towers, Bit and gold; ±1 taps and direct entry for every value. | 02, 03 | v0.2.0, v0.3.0 |
| Battle Map: the shared game board with draggable hero tokens, zoom/pan and gold piles. | 04 | v0.4.0 |
| Initiative Indicator: a badge on both battle screens, tapped to pass initiative each round. | 05 | v0.5.0 |
| Status tokens: +1 Attack, Confuse, Immobilize, Death Mark, Shield, Stone and Chill. | 06–09, 11–13 | v0.6.0–v0.13.0 |
| Hero abilities: To the Pain Arena, Favored Enemy, Ice Wall, Runika's Artifacts and Bear Trap. | 14–18 | v0.14.0–v1.0.0 |
Each feature has an intent (intent/), a spec
(specs/) and a build checklist (plan/), all named
NN_feature-name.md. Next up is v2.0.0: playing without the rulebook,
through quality-of-life fixes and automation. Bugs, ideas and playtest
feedback for it live in BACKLOG.md. The 3-4 player variant
is deferred.
Structure
frontend/: Next.js (App Router) + TypeScript client, statically
exported. Vitest for unit tests, Playwright for e2e. See
frontend/README.md for scripts and deployment.backend/: placeholder, not needed so far.intent/, specs/, plan/: per-feature docs (see above).
Getting started
cd frontend
npm install
npm run dev # local dev server
npm test # Vitest
npm run test:e2e # Playwright
