Dev Notes

Opening Cheat Sheets page (/openings) — 30 curated guides across 5 categories: e4-e5, Semi-Open, d4, Indian Systems, and Flank Openings

Each cheat sheet includes key ideas, plans for White & Black, common traps with explanations, critical positions with FEN, and famous practitioners

Category filter pills, search bar, and difficulty badges (Beginner / Intermediate / Advanced) on the Openings page

Daily Chess Tips widget on the dashboard — 400 entries (quotes, tips, facts, and patterns) rotating by day of year with prev/next browsing

Avatar Frames in the Coin Shop — 12 cosmetic border effects for your profile avatar (Emerald Glow, Fire Ring, Frozen Aura, Royal Purple, Gold Crown, Prismatic Rainbow, Neon Pink, Dark Shadow, Diamond, Rose Gold, Toxic Green)

Animated avatar frames — Rainbow cycles through three colours, Diamond pulses with a white glow

Avatar frames display on the navbar profile picture (desktop & mobile)

Coin Shop standalone page (/shop) with live 4×4 board preview for piece themes

24 Lichess piece themes in the Coin Shop — quality-based pricing from 20 to 250 coins

Guess the Move page (/guess) — play through 100 famous GM games and try to find each move. Supports click-to-move, drag-and-drop, hints, and keyboard controls

10 game collections — World Championship Classics, Bobby Fischer Brilliancies, Kasparov's Immortals, Tal's Sacrifices, Capablanca's Technique, Modern Masterpieces, Romantic Era, Endgame Artistry, Attacking Masterclasses, and Defensive Masterpieces

Side selection — guess as White, Black, or Both sides with auto-play for opponent moves

Game Library modal on the main page — browse and load any of the 100 games into the PGN Analyzer with folder categories and tag filters

Input method tabs on the Control Center — switch between Input PGN, Lichess/Chess.com, and Load Library

Engine-rated moves — after each guess, Stockfish (depth 12) rates both your move and the master's move (Best ✅, Excellent 💎, Good 👍, Inaccuracy ⚠️, Mistake ❌, Blunder 💀)

Emoji result badges on pieces — ✅/⚠️/❌ badge appears on the top-right of the destination square after each guess, matching the analyze page style

Opponent last-move highlighting — from/to squares of the opponent's auto-played move are highlighted in amber

Time Management CTA — after any non-time scan (openings, tactics, endgames, or all) a card suggests running a time management scan

Time Management scan mode — analyses clock data to find rushed moves, wasted time, justified thinks, and time scrambles

Time Management score (0–100), avg time per move, and per-moment breakdown with verdict cards

Time Card grid layout — score, avg/move, justified thinks, wasted time, rushed moves, and time scramble count

Missed tactics now show clock info — time remaining (mm:ss) and percentage of game time left when the tactic was missed

Time Pressure Training mode in Training Center — replay rushed and overthought positions under simulated clock pressure

PGN Game Analyzer page (/analyze) — paste PGN text or upload .pgn files for full move-by-move analysis

Chess.com-style move badges — !! Brilliant, ! Great, ✓ Best, ⊘ Inaccuracy, ? Mistake, ?? Blunder on every move

Interactive analysis board with eval bar, move list, and navigable move history

Sample PGNs — Fischer–Spassky 1972 Game 6 and other classic games available as one-click presets

Lichess / Chess.com game loader modal — paste a game URL to import and analyze it directly

Viral Elo Report modal — shareable card with your estimated rating, accuracy grade, and key stats

Share buttons — post your report to X (Twitter) and Facebook with one click

Accuracy badges on board pieces — each piece shows its move classification (!!, !, ?, ??) directly on the board

Folder tab UI for Opening Analysis — Mistakes, Patterns, and Rankings organized into a clean tabbed layout

Positional pattern detector — identifies Unnecessary Captures, Premature Trades, Released Tension, Passive Retreats, Greedy Pawn Grabs, and more

GM wisdom quotes on each pattern — Igor Smirnov, Kasparov, Nimzowitsch, Capablanca, Tarrasch, and others

"Greedy Pawn Grab" detector — flags when you snatch a pawn with a piece and lose critical tempo

Weakness Trainer — puzzles targeting your worst tactical motifs from scan reports

Speed Drill — timed puzzle rush (3 or 5 min) to build pattern recognition under pressure

Blunder Spotter — find the best move in positions from your own games

Opening Trainer — practice the correct moves in your recurring opening leaks

Endgame Gym — targeted puzzles for your weakest endgame types

Hint button highlights the source square of the expected move with a green glow

Personalized Puzzles section — solve tactics from your own games directly in the report

Puzzles fetched from Lichess puzzle activity API based on your username

Inline expandable board with drag-and-drop moves, move validation, and success/fail feedback

Puzzle counter and navigation — work through your set one by one

Coin Economy — earn virtual coins from scans (+5, up to 3×/day), daily challenges (+10/+3), study tasks (+5), achievements (+20), and repertoire saves (+2)

Coin Shop — spend earned coins on 10 board colour themes (Ocean, Midnight, Coral, Walnut, Ice, Royal, Neon, Candy, Ember) and 6 profile titles

Board Themes — purchased themes apply instantly to every chessboard across the app (drill mode, tactic cards, mistake cards, endgame cards, daily challenge, repertoire, hero board)

Profile Titles — equippable titles (Chess Student, Tactician, Strategist, Master Analyst, Elite Scholar, Grandmaster) shown as a badge on the dashboard header

Coin balance badge in the navbar — shows your current coin count next to the Dashboard link

Daily Challenge — a daily puzzle from your own missed tactics, with streak tracking and answer reveal, right on the dashboard

Progress Highlights — celebratory banners show what improved since your last scan (accuracy, rating, fewer leaks, sharper tactics, etc.)

Opening Repertoire — save correct moves from any leak card to build a personal opening repertoire you can review on the dashboard

Percentile Comparison — see how your accuracy and rating rank against all FireChess users with visual progress bars and motivational messages

Study Plan system — after every scan a weekly study plan is generated with targeted tasks based on your weaknesses

Per-player study plans — each chess username gets its own independent study plan with separate streaks and progress

Opening Rankings — new section showing all your openings with mini chessboards, colour badges, W/D/L record, sorted by win-rate (lowest first)

Mental Game stats now saved to dashboard — composure, tilt score, and archetype persist across sessions

Tactics toggle in Openings mode — flip a switch to also scan for missed tactics without leaving openings mode

Achievements & Badges — 22 unlockable badges on the dashboard based on scan count, accuracy milestones, ratings, streaks, and more

Goal Setting widget — set a target rating or accuracy goal and track your progress on the dashboard with a visual progress bar

Rescan Reminder — dashboard banner nudges you to rescan if your last analysis is more than 7 days old

Share Report Card — Canvas-generated 600×400 PNG image of your report card that you can share on social or download

Weekly Email Digest — opt-in weekly email summary with scan activity, study plan streak, and motivational prompt (Vercel Cron, Resend)

New /feedback page with category picker (Bug, Feature Request, Question, Other) and message form

Admin-only feedback viewer at /admin/feedback with status management (New → Read → Resolved)

Key Stat pill at the top of each expanded card shows your personal metric at a glance

New gradient CTA card after the report with progress tracking pitch and feature pills

Card shows contextual copy for signed-in vs anonymous users

Email magic link sign-in via Resend — enter your email, click the link, you're in

Lifetime Pro plan ($59 one-time) — full Pro features forever with no recurring fees

Promo code field now appears at Stripe checkout

Opening Leak Detection — find repeated positions where you consistently play the wrong move, with drill mode to practice the correct lines

Missed Tactics Scanner — surface forks, pins, skewers, and combinations you overlooked across your games, with motif tagging

Endgame Mistake Scanner — catch losing moves in rook, pawn, and minor piece endgames with position-by-position breakdowns

Strengths & Weaknesses Radar — six-dimension profile (Accuracy, Opening Prep, Tactical Eye, Composure, Time Mgmt, Resilience) with tiered insight cards

Report Card — letter grades (S/A/B/C/D/F) for overall accuracy with estimated rating, centipawn loss, and severe leak rate

Mental Game Stats — composure score, tilt detection, post-loss performance tracking, and player archetype classification

Interactive Drill Mode — practice your opening leaks with a real board, move-by-move hints, and sound effects

Opening Explorer integration — every mistake card links to the Lichess opening database for that position

Move Explanations — see Best Move, Your Move, and Database Move with plain-English reasoning for each flagged position

Eval Bar — real-time engine evaluation bar on every interactive board

Scan Modes — choose between Openings, Tactics, Endgames, or scan everything at once

Dashboard — save reports and track your progress over time with comparison charts

Lichess + Chess.com support — works with both platforms, fetches games from public APIs

Stockfish 18 WASM — all analysis runs client-side in your browser via WebAssembly, no data sent to servers

Multi-worker scanning — parallel Stockfish workers for faster analysis (auto-scales to device cores)

Google + Lichess OAuth sign-in — authenticate with your existing accounts

Free + Pro tiers with Stripe billing — free tier for up to 300 games, Pro for up to 5,000 with deeper analysis