Skip to content
GitHub

UI Overview

Masterboard is organised into several main pages accessible from the left sidebar, plus a mosaic workspace for detailed game work.

The left sidebar is always visible and provides access to:

  • Games — your game library
  • Board — the main analysis and annotation workspace
  • Openings — opening repertoire management and drills
  • Tactics — spaced repetition puzzles extracted from your games
  • Statistics — personal performance analytics across your game history
  • Reports — opponent preparation reports
  • Settings — accounts, engine, and appearance

The active engine name and status are shown at the bottom of the sidebar.

The Games page is your game library. It shows a sortable, filterable list of all your games.

  • Folder tree (left panel): organise games into a hierarchy of folders. Click a folder to filter the list to that folder’s contents.
  • Games list (main panel): columns include players, result, date, ECO code, time control, and source. Click any column header to sort.
  • Filter bar: filter by player name, result, source (chess.com, Lichess, PGN, OTB), or collection.
  • Import button (top-right): opens the import dialog. See Importing Games.
  • Double-click a game to open it on the Board page.

The Board page is the main workspace for reviewing, annotating, and analysing games. It uses a mosaic layout: panels can be freely repositioned and resized.

Board page showing the board, notation, engine, analysis, and explorer panels arranged in a mosaic layout
  • Board panel: the interactive chessboard. Click to make moves; right-click arrows and squares to draw annotations.
  • Notation panel: the move tree. Variations are shown inline in PGN-style notation. Click any move to navigate to that position. The panel header shows the current game’s players, result, date, and ECO classification, and displays per-player accuracy percentages after automated analysis.
  • Engine panel: real-time evaluation from the active engine. Shows the centipawn score, WDL bar, and up to 5 principal variation lines.
  • Analysis panel: shows the evaluation graph across the full game (click any point to navigate to that move), per-player accuracy percentage, ACPL, and inaccuracy/mistake/blunder counts. Available after automated analysis.
  • Explorer panel: shows opening statistics for the current board position. The Master DB tab displays move popularity, W/D/L%, and average Elo from master games. The My Games tab queries your personal game collection with folder, collection, and player name filters. The Repertoire tab shows which of your repertoires cover the current position and what move is prepared.
  • Drag a panel header to move it to a different position in the grid.
  • Drag a panel edge to resize it.
  • Layouts are preserved across sessions.

The toolbar above the board provides:

  • Navigation buttons (start, back, forward, end)
  • Flip board (F key)
  • FEN copy/paste for setting up positions
  • Edit Position for the board editor (drag pieces to set up any position)
  • Analyse to run automated engine analysis on the current game

The Openings page lists all your opening repertoires, grouped by colour (White repertoires first, then Black).

  • Click a repertoire name to open the Repertoire Builder.
  • Click the pencil icon to rename a repertoire inline.
  • New Repertoire button (top-right) to create one.
  • Train All, Train White, and Train Black buttons (top-right, shown when you have repertoires of both colours, White only, or Black only respectively) start a drill session covering those repertoires.
  • The Train button on each row (revealed on hover) starts a drill session for that repertoire only.
  • The Review All button on each row walks every move in that repertoire regardless of SRS due dates.

The Repertoire Builder shares the same mosaic layout as the Board page. Its panels are:

  • Board panel: make moves on the board to add them to the repertoire.
  • Moves panel: shows the variation tree for the current repertoire. Right-click any move for annotations, comments, and branch deletion.
  • Explorer panel: shows opening statistics (Master DB, My Games, and Repertoire tabs) for the current board position. Click a move row to add it directly to the repertoire as an opponent response.
  • Engine panel: real-time engine evaluation, same as the Board page.

The Train button in the Repertoire Builder toolbar starts a drill session for the current repertoire.

Settings is divided into eight sections:

  • General: startup splash screen toggle. See General Settings.
  • Appearance: choose the accent colour palette for the application.
  • Board Appearance: choose the board colour scheme.
  • Engine Configuration: add or remove custom UCI engine binaries. See Engine Configuration.
  • Player Profile: your name variants for personal game identification. See Connected Accounts.
  • Connected Accounts: chess.com and Lichess usernames. See Connected Accounts.
  • Master Game Database: import, manage, and re-import the master position index. See Master Database.
  • Position Index: manage the personal game position index used by the Explorer panel’s My Games tab.

The sun/moon button in the top-right corner of the app window switches between dark and light mode. Your preference is saved and restored on the next launch.