Setup Selector¶
The Setup Selector is your hub for managing and switching between different saved setups. Think of it as your setup library - a quick way to browse, search, and load any configuration you've previously saved.

Overview¶
When you open the Setup Selector, you'll see a table view of all saved components under the current component type. The interface consists of:
Header Bar¶
- Search input - Filter by setup name, tag names, or note content
- Help icon - Shows keyboard shortcuts for selection and loading
- Active filter chips - Display current filters with quick remove buttons
Command Bar¶
Always visible at the top of the table area, the command bar shows:
- Selection count - When items are selected (e.g., "2 selected")
- Clear selection - Button to deselect all items
- Summary - View full details of a single component
- Rename - Rename every version of the selected setup at once
- Compare - Compare two or more selected components
- Compare with Current - Compare selected item against currently loaded setup
- Archive - Archive selected items (orange button)
- Lock / Unlock - Lock or unlock every selected component in one click, preventing new versions being saved over them
- Restore - Bring archived setups back (shown when the archived filter is on)
- Export - Export the selected component as a JSON file, or several selected components together as a single zip file
- Import JSON - Import one or more components from JSON files
The command bar always stays on a single row. When space is tight it drops the button labels and shows icons only (hover a button to see its name), so the list never shifts when you select a row.

Filter Bar¶
A row of filter dropdowns sits above the table, laid out like the Results Library, and is replaced by the command bar while anything is selected:
- Created - Quick filters (Last 7/30/90 days) and a custom date range
- Modified - Quick filters and a custom date range
- Tags - Add/remove tags and filter by "Has any tag"
- Notes - Setups with or without notes
- Versions - Latest versions (default), Published only, or All versions
- Archived - Active (default, hides archived), Include archived (shows both), or Archived only
Each active filter shows an X beside it; Clear all resets every filter at once.
Table View¶
Each entry displays:
- Name - The setup name with its ID badge showing the version number
- Edited At - When the setup was last modified
- Tags - Labels for organization (inline editable)
- Notes - Documentation or comments (inline editable)
- Edited By - Team member who last modified it
Hover a row for quick actions at its right edge (Duplicate, Compare with Current, Restore for archived setups, Lock/Unlock). The ⋮ menu at the end of the row holds everything: Duplicate, Lock, Rename, View Summary, Compare with Current, Move to folder, Export JSON, and Archive or Restore.
The Current Setup¶
The setup currently loaded in the vehicle is pinned at the top of the list, marked with a pin, whichever folder you are browsing, with a chip showing where it is filed. It sits under a Loaded in vehicle label, and the folder listing below it under its own label (In and the folder's name, or Search results), where it is not repeated. Selecting it highlights it the same way as any other row.
Resizing Columns¶
Drag the divider between any two column headers to resize a column; the new width is saved and persists across page reloads. Double-click a divider to reset that column to its default width.
Choosing Which Columns to Show¶
The Columns button opens a column visibility menu for toggling Edited At, Tags, Notes, Edited By and Bundle on and off. Name always stays visible. Your choices are remembered between sessions, alongside the column widths.
Loading a Setup¶
To switch to a different setup:
- Click on the setup you want to load (it will highlight in purple)
- Click the "Load Selected" button in the footer
- The component will update with the selected configuration
Alternatively, double-click a setup to load it immediately and close the dialog.
Quick Load
Double-click any row to load it instantly without needing to click "Load Selected".
Mixing Components From Different Vehicles or Templates
Setup Selection happens per component, not per vehicle. A component you load (springs, tyres, aero, etc.) isn't locked to the vehicle or template it was originally created on — you can load a suspension setup from one template car and a tyre model from another onto the same vehicle. To combine values from two different vehicles (for example, mixing values from a TCR template with a GT3 template), open the Setup Selector for the specific component you want to change — either from its page or by clicking its folder icon in the Tree View — and load the version that came from the other vehicle/template.
Version History¶
Setups that have previous versions show an expand button next to their name. Click it to reveal the version history, showing older versions with their published status and timestamps.
Archived versions are hidden from the version history unless Archive Status is set to include them, and the history refreshes when you change that filter.
Version rows use the same selection model as normal setup rows. Click a version to select it, then use the command bar at the top of the table to view, compare, or load the selected item. You can also click Load on a historical version row to load that version directly.
History is loaded a page at a time. Components with long histories show a Load more control to fetch the next page — previously anything past the 100th version was silently unavailable. A search box also lets you jump straight to a known version number instead of paging through.

Tag Management¶
Tags help you organize and categorize your setups for easy retrieval.
Adding Tags¶
- Click the tag cell next to a setup in the table
- Type the tag name (e.g., "race", "qualifying", "wet weather")
- Press Enter to save
Adding Multiple Tags¶
Separate tag names with commas to add several at once:
Using Tags¶
Tags make it easy to:
- Group similar setups together
- Find setups for specific conditions
- Filter by track, weather, or tyre compound
- Organize team workflows
Tag Naming
Use consistent tag names across your team for better organization. Consider creating a tagging convention like "track-name", "condition", "purpose".

Multi-Select Operations¶
Selecting Multiple Setups¶
You can select multiple setups using:
- Click - Select a single item
- Ctrl+Click (Cmd+Click on Mac) - Add individual items to selection
- Shift+Click - Select every row from the last one you clicked to this one, folders included
- Select All (beside the Columns button), Ctrl+A (Cmd+A on Mac) or the right-click menu - Select every folder and setup in the list, including setups further down that have not loaded yet
A command bar appears at the top showing how many items are selected, with a clear button and bulk actions. Press Esc to clear the selection; with nothing selected, Esc closes the selector.
Multi-Select Pickers¶
Where a picker lets you choose several setups (for example when adding a setup dimension to a sweep), Shift+Click selects the range between your last click and the row you click; Shift+Click on an already selected row deselects that range. The list loads more setups as you scroll, and the footer reminds you: "Shift-click to select a range". The component loaded in your vehicle is pinned at the top under Loaded in vehicle, whichever folder you are browsing, and can be selected like any other row.
Duplicating a Setup¶
Click the copy icon on any row to duplicate that setup. This creates an exact copy that you can then rename and modify.
Renaming Setups¶
Use Rename in a row's actions menu to change a setup's name. Every version of the setup is renamed in place, so no new version is created and the version history stays intact.
Rename is refused when:
- the lineage is locked
- the setup was delivered through a bundle
- the new name is already used by another setup (the message says what holds it: an active, unpublished, locked, archived or bundle setup)
Renaming a math channel also updates every equation that refers to it, in every version, so they keep working. Its new name follows the same rules as any math channel name: letters, numbers and underscores, not starting with a number. A math channel you share in a bundle cannot be renamed; remove it from the bundle first.
You can also rename from the setup header: click the name to open a popover on Rename, with a Save as new toggle if you want a separate setup instead (see the Setup Command Palette).
Archiving Setups¶
Archiving replaces permanent deletion, allowing you to clean up your setup list while keeping the ability to restore items later.
To archive setups:
- Select one or more setups
- Click the archive icon (orange) in the command bar
- Confirm the archive operation

Archiving frees the name
When no published, unarchived version of a setup is left, the whole setup is renamed to <name> (archived <date>) (if that name is already taken, (2) is added after it), so you can reuse the original name. Locked and bundle-delivered setups, and math channels, keep their name when archived. Restoring removes the suffix, or numbers it <name> (2) if the name has been taken in the meantime. Archiving only an old version while the current one stays does nothing to the name.
Archiving vs Deleting
Archived setups are hidden from the default view but can be restored at any time. Set the Archive Status filter to Include Archived or Archived Only to view and restore archived setups.
Restoring Archived Setups¶
- Set the Archived filter to Include archived or Archived only
- Archived setups appear with an "Archived" badge
- Click the restore icon on any archived setup to unarchive it

Folders¶
Each component type has its own folders: the folders you make for springs are separate from the ones for vehicles or tracks. Folders only organise the list; a setup loads the same way wherever it is filed.
Browsing Folders¶
A breadcrumb above the table shows where you are, starting at Root. Folders appear as rows at the top of the table.
- Double-click a folder row to open it; a single click selects it, like any other row
- Click a breadcrumb to go back up
- New Folder (beside the breadcrumb, or right-click anywhere on the table) creates a folder inside the one you are viewing; rename it from its row
Searching or filtering looks across every folder. While a search is active the breadcrumb reads Search results for “…” (or All folders when only a filter is set), folders whose name or notes match are listed above the setups, and a Location column shows the folder each row lives in. Double-click a folder in the results to open it, which clears the search.
Hover a setup or folder and click the star beside its name to star it. The Starred button beside the breadcrumb lists every starred setup and folder of this type, from every folder; click it again to go back. Stars are shared by the whole team, and members with the Viewer role cannot star items.
To rename a setup or folder, hover its name and click the pencil beside it, the same as in the Results Library. When you drag rows, copies of them gather into a single tag under the cursor showing the name of the row you picked up and, when you drag several, how many are moving. The rows stay in place, dimmed, until they have moved.
Right-click a folder row for Open, Rename, Copy path, Move to folder and Delete folder. Copy path is also in the folder's ⋮ menu, and the copy button beside the breadcrumb copies the path of the folder you are viewing.
Moving Setups into Folders¶
Either:
- Drag one or more rows onto a folder row, or onto a breadcrumb to move them up the tree
- Select the rows and use Move in the command bar, then pick a folder
A setup and all of its versions move together. Every version of a setup is always in the same folder, so moving an older version from the version history moves the whole setup.
Renaming and Deleting Folders¶
Hover a folder row for the pencil (rename) and bin (delete) icons at its right edge, or use its ⋮ menu (Rename, Move to folder, Delete folder). Renaming opens a small box with the name, the same as in the Results Library. Selecting one or more folder rows puts Rename, Move and Delete on the command bar, so several folders can be moved or deleted at once. Deleting a folder also deletes its subfolders, but never the setups inside: they move to the folder above.
Folder Notes and Tags¶
A folder row fills the same columns as a setup: click its Tags or Notes cell to edit them, the same way as for a setup. Edited At and Edited By show when the folder was last created, renamed, moved or annotated, and by whom.
Searching and Filtering¶
The Setup Selector includes powerful search and filtering capabilities.
Basic Search¶
Type in the search bar to filter by setup name, tag names, or note content.
Filters¶
The filter bar above the table has a dropdown per filter:
Date Filters¶
- Created - Filter by when the setup was originally created
- Modified - Filter by when the setup was last edited
Quick date buttons: Last 7 days, Last 30 days, Last 90 days, or a custom range using the calendar pickers.
Tags Filter¶

- Tag input - Type and press Enter to add tags
- Has any tag - Only show setups that have at least one tag
Notes Filter¶
- Has notes / No notes - Only show setups with, or without, notes
Versions¶
- Latest versions (default) - Show published and most recent drafts
- Published only - Show only published versions
- All versions - Include full version history
Archived¶
- Active (default) - Hide archived components
- Include archived - Show both active and archived components
- Archived only - Show only archived components
An active filter shows an X beside it to remove it; Clear all resets everything.
Filter Persistence
Your filter settings are saved per component type. When you reopen the Setup Selector, your previous filters are automatically restored.
Default View
By default, only published components and the latest version of each component are shown. Use the advanced filters to see all versions or archived items.
Sorting¶
Click any sortable column header to sort by that field. Click again to toggle between ascending and descending order. Sort indicators appear next to the column name.
Comparison Features¶
View Single Component¶
Select a single item and click View to see all fields and details in a comparison view.
Compare Two or More¶
Select multiple items and click Compare to open the comparison view showing differences between setups.
Historical versions can be selected and compared the same way as current rows, so you can compare an older version against the latest setup or against another selected version.
Compare with Current¶
When a different setup is selected, you can compare it against the currently loaded setup to see what has changed.

Import and Export¶
Export as JSON¶
Select a single setup and click Export to download the component data as a JSON file. This can be used for backup or to share setups externally.
Select two or more setups and Export downloads them together as a single zip file. Large selections are sent in batches of 100 automatically, and a progress indicator shows how far through the batch you are. Any component that could not be exported is recorded in the zip's manifest rather than failing the whole download.
Import from JSON¶
Click Import JSON and choose where the files come from: this computer, Google Drive or OneDrive / SharePoint (see Importing from Google Drive or SharePoint). Then select one or more JSON files. Before anything is saved, a preview step lets you confirm or edit the name each component will be given. When importing several files at once, you can choose whether names come from the name stored inside each file or from the file name itself — useful when files have been renamed by hand and the two disagree.
An import never creates a duplicate of something your team already has. Every named component in the file — the car itself, its suspensions, each spring, damper, tyre and so on — is compared with your team's component of the same name. If the two are identical, the import links to the one you already have instead of adding a copy, so re-importing a car you exported earlier adds nothing and leaves the library clean. Notes, tags, lock state and version history are not part of that comparison.
If a name is already used by a component with different contents, you are asked what to do with it rather than having (2) added quietly. For each clash you can:
- Update — the file's version becomes the next version of your team's component, with the same name and folder. Your current settings stay in its version history, and vehicles already using the old version are unchanged. Not offered for a locked, archived, hidden or bundle component; the dialog says why.
- Skip — use your team's version; the imported car points at the component you already have, and the file's settings for it are not imported. Components inside a skipped one are not asked about.
- Keep both — the file's version is imported as a separate component. Type a name for it, or leave it blank for
<name> (2).
Each clash lists what differs between your team's version and the file's, and Update all, Skip all and Keep both for all set one choice on every row at once. The same dialog tells you how many identical components will be linked. If a new name you choose is itself taken, the dialog asks again.
Importing several files at once works the same way: files with no clashes are imported straight away, and the files whose names clash are collected into one dialog, each entry labelled with the file it came from. Answer them and only those files are sent again; closing the dialog instead leaves them out, and the summary counts them as skipped. Each file is imported independently, so one invalid file does not roll back the rest, and the summary afterwards says how many were imported, how many were already in your library, and how many failed.
When a file is rejected, the message lists what is wrong: the required fields that are missing and any values that are invalid, each with its path through the component (for example front suspension › kinematics › arb lever delta by position). A component exported before a field existed is the usual cause.
Common Workflows¶
Organizing Setups by Track¶
- Create a folder per track (e.g., "Silverstone", "Spa") and drag each setup into it
- Or add the track name as a tag to each setup and use the Tags filter
- Quickly compare different configurations for the same track
Finding Recent Changes¶
- Open the Modified filter
- Pick "Last 7 days" or a custom range
- Review what your team has been working on
Cleaning Up Old Setups¶
- Sort by "Edited At" column
- Use Shift+Click to select old setups
- Archive outdated configurations (they can be restored if needed)
ID Badge¶
Each setup name is accompanied by an ID badge showing the version number:
| Visual | Meaning |
|---|---|
| Green text/border | Latest component |
| Orange text/border | Not Latest component |
| "A" suffix | Archived component |
Hover over the badge to see full metadata including:
- Version number
- Whether it's the latest version
- Archived status
- Created date and time
- Last modified date and time
- Who edited it
Next Steps¶
- Learn about the Setup Command Palette for managing individual setups
- Explore Getting Started to create your first setup
- Read about User Settings to customize your experience