# SettingsField

> One setting: what it does, in a line, and its control.

- **Level**: molecule · **Status**: stable · **Role**: input
- **Import**: `import { SettingsField } from "@rrios-forge/ui/molecules/settings-field";`
- **Source**: `packages/ui/src/molecules/settings-field`

One-row settings layout. Title + description on the left, control + action on the right. Stacks below sm. Use Field underneath for the actual <label htmlFor> wiring; SettingsField title is the visible name. Patterns consulted: Patterns/Forms · FieldAnatomy, Patterns/Density & Growth · DensityLevels.

## Use it for

- Binary toggle / checkbox / radio group → `Switch` (in `SettingsField` with label) / `Checkbox` / `ChoiceGroup` with `Radio`

## Axes

| Axis | Part | Values | Default | Meaning |
|---|---|---|---|---|
| `density` | — | `compact` `comfortable` | — | — |

## Stories

- [Playground](/?path=/story/components-molecules-settingsfield--playground) · frame: `/iframe.html?id=components-molecules-settingsfield--playground&viewMode=story`
- [With switch](/?path=/story/components-molecules-settingsfield--with-switch) · frame: `/iframe.html?id=components-molecules-settingsfield--with-switch&viewMode=story`
- [With select](/?path=/story/components-molecules-settingsfield--with-select) · frame: `/iframe.html?id=components-molecules-settingsfield--with-select&viewMode=story`
- [With button](/?path=/story/components-molecules-settingsfield--with-button) · frame: `/iframe.html?id=components-molecules-settingsfield--with-button&viewMode=story`
- [Compact](/?path=/story/components-molecules-settingsfield--compact) · frame: `/iframe.html?id=components-molecules-settingsfield--compact&viewMode=story`
- [Disabled control](/?path=/story/components-molecules-settingsfield--disabled-control) · frame: `/iframe.html?id=components-molecules-settingsfield--disabled-control&viewMode=story`

## Always

- Tokens only (R04); variants are semantic axes, never appearance (R02).
- Typography and actions are Poesía atoms, never raw HTML with utilities.
- Vibrant panes need a ground and never nest (ADR-027).