Selection Fields

Four field types let records choose from predefined options. All share the base field properties.

Type	Stores
checkbox	A boolean true/false value.
single-select	One option chosen from a predefined list.
multi-select	Multiple options chosen from a predefined list.
status	A colored workflow state from a list of { value, color } options.

checkbox

Boolean field, typically rendered as a checkbox.

Property	Description
default	Default boolean value (true / false).

- { id: 1, name: is_active, type: checkbox, required: true, default: false }

single-select

A single choice from a list of string options.

Property	Description
options	Array of strings defining the available choices.
default	Default selected option (a string).
conditions	Optional behavioral conditions: [{ when: <option>, then: { …property changes } }] — apply property changes (e.g. readOnly) when a specific option is selected.

- id: 2
  name: category
  type: single-select
  options: [Electronics, Clothing, Food]
  default: Electronics

multi-select

Multiple choices from a list of string options.

Property	Description
options	Array of strings defining the available choices.
maxSelections	Maximum number of choices (integer ≥ 1; cannot exceed options.length).
default	Default selections (an array of strings).

- id: 3
  name: tags
  type: multi-select
  options: [Urgent, Important, Review]
  maxSelections: 3

status

A colored workflow state. Each option is an object with a value and a color, ideal for Kanban columns and pipeline stages.

Property	Description
options	Array of { value, color } objects defining the colored states.
default	Default status value (a string matching one of the option values).

- id: 4
  name: status
  type: status
  options:
    - { value: todo, color: '#94A3B8' }
    - { value: in_progress, color: '#3B82F6' }
    - { value: done, color: '#10B981' }
  default: todo