Skip to content
GitHub

Building a Repertoire

A repertoire in Masterboard is a named collection of opening lines for one colour. You can have multiple repertoires — for example, one for your main 1.e4 system and one for your 1.d4 lines.

  1. Go to the Openings page from the left sidebar.
  2. Click New Repertoire.
  3. Choose White or Black and give the repertoire a name (e.g. “1.e4 Repertoire” or “Sicilian Defence”).
  4. The repertoire is created and the Repertoire Builder opens automatically.
Repertoire Builder showing the board, variation tree, and Explorer panel with master database statistics

The Repertoire Builder shows an interactive board and a variation tree in the Notation panel.

Make moves on the board to add them to the repertoire. After each move, the tree panel updates to show the new branch.

To add a second line from the same position:

  1. Navigate back to the branching point using or by clicking the move in the tree.
  2. Play a different move. A new branch is created automatically.

For example, after 1.e4, navigate back to move 1 and play 1.d4 to begin a second opening system.

Right-clicking any move in the Notation panel opens a context menu with:

  • Add comment — attach a free-text note to that move
  • Add NAG — mark the move with a symbol (!, ?, !!, ??, !?, ?!)
  • Delete branch — remove the move and all continuations from that point

To change the order of sibling moves in the tree, drag any move up or down using the drag handle that appears on hover, or use the up/down controls in the context menu. Branch order is persisted in the database and determines the default weight order when exporting a Polyglot book — the first sibling gets the highest weight.

From the Openings list page, click the pencil icon next to a repertoire name to rename it inline. Press Enter to confirm.

Each move in the tree displays a small colour-coded dot reflecting its FSRS recall probability:

ColourMeaning
GreenWell retained (≥ 0.9)
YellowDue soon (0.7–0.9)
RedOverdue or weak (< 0.7)
GreyNever reviewed

Use the heatmap to identify branches that need attention. Right-click any move and select Train branch to drill that subtree directly.

Starting a drill session from the Repertoire Builder

Section titled “Starting a drill session from the Repertoire Builder”
  • The Train button in the toolbar starts a due-date drill session for the current repertoire.
  • The Review All button walks every move in the repertoire once in depth-first order, ignoring SRS due dates. Use this for pre-tournament preparation.
  • Right-click any move and select Train branch to scope the session to that subtree.

The Explorer panel on the Repertoire Builder page includes a Repertoire tab. For the current board position it shows which of your repertoires cover that position and what move is prepared. Use it alongside the Master DB and My Games tabs to understand the relationship between your preparation and master practice at each position.

The Repertoire Builder uses the same mosaic layout as the Board page. The Board, Moves, and Explorer panels can be independently resized and repositioned by dragging their headers and edges.

You can compile any repertoire into a Polyglot .bin opening book for use with engines and GUIs such as Arena, Cute Chess, or Scid vs. PC. From the Openings page, open the context menu for a repertoire and choose Export Polyglot. Move weights in the exported file follow branch order by default; use the optional Edit weights step before export to assign custom percentages to positions with multiple candidate moves.

To import an existing .bin file as a repertoire, create a new repertoire and choose a .bin file as the source instead of PGN. Polyglot books carry no annotations, so comments and NAGs will be absent from the imported repertoire.

See Polyglot Books for full details on the export and import workflow.

  • Import lines from a PGN file to populate your repertoire quickly.
  • The Explorer panel shows move statistics from the master database and your personal games for every position in the repertoire. See Master Database.
  • Polyglot Books — export your repertoire as a .bin file or import an existing book.