Builder Repertoires

The Repertoire Card allows you to organize your repertoires in a clean, nested folder structure for fast and intuitive access. It provides a flexible way to group, color-code, and manage your repertoires, helping you maintain a clear overview even as your collection grows.

The Repertoire Card introduces a folder-based approach to repertoire management. You can create, rename, and delete folders; assign colors to them for easier visual grouping; and drag-and-drop both folders and repertoires to nest them within each other. You can also click on folders to collapse or expand them, making it easier to navigate large repertoires. Clicking on a repertoire will load it directly in the Builder, and a configuration button will appear on the right-hand side, allowing you to adjust your repertoire settings. Right-clicking on a folder or repertoire opens a context menu, giving you quick access to options such as renaming, recoloring, or deleting.

This flexible design enables you to:

◦ Organize repertoires hierarchically: Use folders to create a logical nested structure
◦ Assign custom colors: Add visual identifiers for quick recognition
◦ Drag and drop: Move repertoires or folders easily to restructure your layout
◦ Collapse and expand folders: Click a folder to hide or reveal its contents
◦ Load and configure repertoires: Click a repertoire to open it in the Builder and access configuration options on the right
◦ Right-click actions: Access quick options such as renaming, changing color, or deleting items

Tip: Use folder colors consistently to reflect categories such as "White", "Black", or "In Progress." Keep folder names short and descriptive to improve visibility on smaller screens.

Edit Repertoire

When you click on the Edit Repertoire button, a dialog window will open allowing you to modify the details of your selected repertoire. From here, you can adjust key attributes and manage the repertoire’s organization within your folder structure.

Within the dialog, you can update the following fields:

◦ Name: Set or update the repertoire title
◦ Description: Provide an overview or personal notes for reference
◦ Author: Specify the creator or owner of the repertoire
◦ Orientation: Choose whether the repertoire is for White or Black
◦ Folder: Assign or move the repertoire to a specific folder

The dialog also includes a Delete Repertoire option. To confirm deletion, you must type the repertoire’s name in the confirmation field before proceeding.

Warning: Once deleted, your repertoire is permanently removed and cannot be recovered. There is no undo functionality.

At the top of the Repertoire Card, there are four main buttons that help you manage and expand your repertoire collection:

◦ Add Repertoire: Create a new blank repertoire that you can build from scratch
◦ Import Repertoire: Import a repertoire from a PGN file (pasted or uploaded), or directly from a public Lichess Study
◦ Import Template: Load an engine-approved repertoire template that you can customize, prune, and refine into your own
◦ Repertoire Wizard: Set up a starting position and automatically generate a move tree using the engine

Import Repertoire

The Import Repertoire feature allows you to bring existing repertoires into the application from external sources.

You can import in one of the following ways:

◦ Paste PGN: Copy and paste a single PGN directly into the input box. The PGN must represent one continuous move tree.
◦ Upload PGN File: Upload a PGN file from your computer. The file must contain only one move tree (multi-game PGNs are not supported).
◦ Import from Lichess Study: Enter your Lichess username to view your public studies, click on the desired study, then select a chapter to import.

Info: Only one move tree can be imported at a time. If your PGN contains multiple games or branches, please clean or merge them before importing.

Tip: Use the Lichess Study import option to quickly integrate your online analysis work into your repertoire builder.

Import Template

The Import Template feature provides access to a large collection of pre-generated repertoires that you can use as a foundation for your own study and customization. This is designed to help you kick-start your repertoire journey with professionally evaluated move trees.

We currently offer over 100 pre-generated templates created using Stockfish 17.1 at depth 20. Each template includes evaluation-backed moves and a clear structural overview to help you begin with a strong, engine-approved base.

When browsing the available templates, you can:

◦ View Orientation: Check whether the template is designed for White or Black
◦ See Move Count: Quickly assess how extensive each template is by its total move count
◦ Read Descriptions: Each template includes a brief description outlining its theme or key opening concepts
◦ Search and Browse: Use the search bar to find a specific opening, or explore through the paginated list

Tip: Templates are a great way to begin building your own repertoire — simply import one and start pruning, annotating, or expanding it to match your personal style.

Note: If there is an opening you would like to see added, please get in touch — we’re always expanding the available template collection.

Repertoire Wizard

The Repertoire Wizard is a powerful tool that allows you to automatically generate a move tree from any starting position using the engine. It’s ideal for creating new repertoires or exploring opening branches with full control over depth and move parameters.

Within the wizard, you can configure several key parameters before generation:

◦ Board Position: Set up any position as the starting point of your repertoire
◦ Repertoire Colour: Choose whether to generate moves for White or Black
◦ Depth: Set the engine depth (e.g., 20) to control how deeply the position is analyzed
◦ PV (Principal Variations): Define how many top lines the engine should consider during generation
◦ Half Moves: Specify how many half moves the tree should expand before stopping

Once configured, the wizard will display an estimated number of moves that will be created based on your selected parameters, click Build Repertoire to let the wizard build a full move tree based on your settings. You can preview the generated repertoire before saving it permanently, or click Cancel at any time to discard the results and keep what has already been generated.

Tip: Please check your usage limits before running the wizard. If the total number of generated moves exceeds your allowed limit, you will not be able to save the repertoire. Imagine spending 20 minutes generating a repertoire only to encounter an error — verify your limits first to avoid frustration.

Warning: Performance depends heavily on your machine’s processing power and the chosen settings. Higher depths and PV values will significantly increase computation time.

Prev: Chessboard

Next: Moves Card