UI Overview

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

Sidebar navigation

The left sidebar provides access to the app’s main pages, in this order:

• Home — the main analysis and annotation workspace (open a game to load it onto the board)
• Games — your game library
• 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 sidebar can be collapsed to icons using the chevron at its foot. Two activities are reached from inside the Games page rather than the sidebar: recording an over-the-board game and Guess the Move (see OTB Recording and Training).

Games page

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, event, ECO code, time control, source, collections, and indicators for analysis and review status. Click any column header to sort, or use the column menu to show and hide columns.
• Filter bar: filter by player name, result, source (Manual, Lichess, Chess.com, PGN import — over-the-board recordings appear as Manual), date, or collection.
• Import menu (in the titlebar): import from a PGN file, a PGN folder, chess.com, Lichess, or a Lichess Study. A Record button for over-the-board games sits alongside it. See Importing Games.
• Double-click a game to open it on the Home page.
• Right-click a game for actions: Analyse, Move to folder, Assign to collections, Mark reviewed / Unmark reviewed, Guess the Move, and Delete.

Home page

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

Panels

• Board panel: the interactive chessboard. Click to make moves; right-click arrows and squares to draw annotations. A vertical evaluation bar beside the board reflects the engine’s score while it analyses.
• 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, search depth, 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.

Rearranging panels

• 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.

Board toolbar

The toolbar above the board provides:

• Navigation buttons (start, back, forward, end), and flip board (F key)
• FEN — copy the current position’s FEN to the clipboard, or load a position from a pasted FEN
• PGN — paste a PGN to load it onto the board
• Edit Position for the board editor (drag pieces to set up any position)
• Edit Metadata to edit the game’s players, Elo ratings, event, site, date, result, and ECO
• Analyse to run automated engine analysis on the current game

Openings page

The Openings page is a single two-pane workspace. A persistent side-nav on the left lists your repertoires; selecting something there drives the mosaic workspace on the right. There is no separate list page or builder page.

Side-nav (left pane):

• Repertoires are grouped under collapsible White and Black headers. Click a header to scope the workspace to that colour; click the chevron to expand or collapse the group.
• Click a repertoire row to scope the workspace to that single repertoire (this is “editor mode” — see below). Each row shows a due badge (moves scheduled for drilling) and, when relevant, an amber gaps badge (positions where your games left preparation).
• Hover a row for inline actions: rename, reset drill progress, Export (PGN or Polyglot .bin), and delete.
• At the foot of the side-nav: a New repertoire button and an Import menu (Import PGN file, Import Lichess Study, Import Polyglot .bin).

Workspace (right pane) behaves according to the side-nav selection:

Selection	Mode	Editing
A single repertoire	Editor — its full move tree	Full editing (add moves, annotate)
White or Black	Aggregate viewer — all that colour’s lines together	Read-only
Nothing	Empty	—

In editor mode the workspace uses the same mosaic layout as the Home page:

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

Training is launched from the titlebar toolbar, which always shows Train All and Review All, plus a scope-specific button that follows your selection (e.g. Train White, or Train [repertoire name]). See Training.

Settings page

Settings is divided into ten sections:

• General: startup splash screen toggle and sound effects toggle. See General Settings.
• Appearance: choose the accent colour palette for the application.
• Board Appearance: choose the board colour scheme and piece set.
• Openings: toggles for the coverage indicator, move heatmap, and deviation marker.
• Engine Configuration: manage UCI engines and set hash, threads, and analysis depth. See Engine Configuration.
• Player Profile: your name variants for personal game identification. See Connected Accounts.
• Connected Accounts: chess.com and Lichess usernames, Lichess OAuth, and per-account automatic background sync. See Connected Accounts.
• Master Game Database: download, switch, and update the master position database. See Master Database.
• Position Index: re-index the personal game position index used by the Explorer panel’s My Games tab.
• Software updates: check for a newer release of Masterboard.

Theme toggle

The sun/moon button at the foot of the left sidebar switches between dark and light mode. Your preference is saved and restored on the next launch.