Skip to content

Setup Command Palette

The Setup Command Palette is your primary interface for managing and interacting with vehicle components. It appears at the top of each component page and provides quick access to essential actions.

Setup Command Palette

Overview

The Setup Command Palette contains the following controls, from left to right:

Component Name

Click on the component name to edit it inline. This allows you to give descriptive names to different setups. The component title (e.g., "Front Left", "Rear") is shown as an abbreviated prefix in purple, and positional titles are shortened to save space (e.g., "FL", "RR", "F Heave").

Editing component name

When you click the name, it switches to an input field. Press Enter or click the checkmark to save, or click the X to cancel. Saving the name also saves the component.

Unsaved Changes Indicator

If you've edited the component name, it will be highlighted in yellow to indicate unsaved changes.

ID Badge

Next to the component name, you'll see an ID badge showing the component's local ID. The badge communicates three independent states at a glance through its visual treatment:

State Visual Indicator
Published Green border and text
Unpublished Orange border and text
Latest version Solid border
Older version Dashed border
Archived An "A" suffix appears after the ID number

For example, a badge showing 42 in green with a solid border is a published, latest-version component. A badge showing 38 A in orange with a dashed border is an unpublished, older, archived component.

Hover over the badge to see full details including published status, version status, archived status, creation and modification dates, and who last edited it.

Folder Icon (Setup Selector)

Opens the Setup Selector to browse, search, and load any saved setup for this component type.

Save Icon

Save Icon

Saves the current setup, preserving any changes you've made to the component. A yellow dot appears on the save icon when there are unsaved changes.

Publish Icon

Opens the Publish Component popover, which lets you share your component with your team. You have two publishing options:

  • Update current - Publish this as the new version under the same name. The previous published version is unpublished but remains in version history.
  • Create new branch - Publish as a new separate component with a different name. The original remains published alongside the new variant.

Publish

When to Branch

Use "Update" for iterative improvements to the same setup. Use "Create new branch" for distinct variants, e.g., "Monaco High Downforce" vs "Monza Low Drag".

Overflow Menu (•••)

Overflow Menu

Opens additional options:

  • Notes - Add notes and comments to the component. A blue dot appears on the overflow button when notes exist.
  • Hide/Show - Toggle component visibility for other team members.

Notes

Notes

Click Notes in the overflow menu to open a text area where you can document setup decisions, test results, or future modifications. Click Save to persist the notes, or Cancel to discard changes.

Hiding Components

Hide Button

Hiding a component completely removes it from view for other team members. Use this to:

  • Keep experimental setups private
  • Hide work-in-progress configurations
  • Maintain a clean workspace for your team

When a component is hidden, the hide button changes to a Show button to restore visibility. While hidden, the name editing and save actions are disabled.

Unsaved Changes Protection

The Setup Command Palette protects you from accidentally losing work:

  • Route navigation - If you try to navigate away with unsaved changes, a confirmation dialog asks whether to stay or leave without saving.
  • Browser close/refresh - The browser will prompt you before closing or refreshing if there are unsaved changes.

Common Workflows

Creating Setup Variations

  1. Open the component you want to vary
  2. Make your changes
  3. Click the Publish icon
  4. Choose Create new branch
  5. Give it a descriptive name (e.g., "Spa Wet Setup")
  6. Click Publish - your original setup remains unchanged

Iterating on a Setup

  1. Make changes to your component
  2. Click the Publish icon
  3. Choose Update to publish as the latest version
  4. The previous version is preserved in version history

Documenting Changes

  1. Make changes to your component
  2. Click the overflow menu (•••) then Notes
  3. Document what you changed and why
  4. Click Save

This helps you and your team understand the reasoning behind different configurations.

Next Steps