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 either paste or upload a PGN file, or import directly from a public Lichess Study.

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

(Section placeholder – describe how to load predefined templates or sample repertoires)

Repertoire Wizard

(Section placeholder – describe how the wizard guides users through building a new repertoire step-by-step)