Skip to main content

Change Formatters

Change Formatters are reusable parameter-grouping specs. They drive the layout of:

Find the admin at Admin → Change Formatters. Route: /admin/change-formatters. API: /change-formatters.

What a formatter contains​

A formatter is keyed by the entity type it applies to (Setup, Tyre, etc.). Inside, it carries:

  • groupedParameters — an ordered list of groups, each with a name (the section heading) and a parameters array (parameter names in order)
  • An optional units map for per-parameter unit overrides
  • An optional precision map for per-parameter rounding

For example, a Setup formatter might group:

Front suspension:    SpringRateFL, SpringRateFR, BumpFL, BumpFR, ReboundFL, ReboundFR
Rear suspension:     SpringRateRL, SpringRateRR, BumpRL, BumpRR, ReboundRL, ReboundRR
Aero:                FrontFlap, RearWingAngle, GurneyHeight
Brakes:              BrakeBias, BrakeDuctFront, BrakeDuctRear
Alignment:           CamberFL, CamberFR, CamberRL, CamberRR, ToeFL, ToeFR, ToeRL, ToeRR

Anything not listed in a group is dropped (or appended in an "Other" section, configurable per formatter).

The admin​

Master/detail:

  • Left — formatter list grouped by entity type
  • Right — group editor (one card per group; reorder groups, reorder parameters within a group)

What you can do today​

  • Author multiple formatters per entity type
  • Use a formatter from the Setup Comparison screen's picker
  • Use a formatter implicitly from the Run Sheet's Setup Change tab (per-account default)

What's coming​

  • Default-formatter picker — let the account pick which formatter is the default per entity type
  • Conditional grouping — show / hide a group based on a predicate (e.g. only show the "Wet weather" group when the current weather row is wet)
  • Delta thresholds — colour parameters whose A↔B difference exceeds a threshold