# Settings group

- **[Atoms](/components/)**

A title, an optional description and one card of rows ruled by hairlines. The home of every settings screen; its rows answer its own width.

## Preview

settings-group.tsx

```
import { Theme } from '@/components/klarhimmel/theme/style';
import { SettingsGroup, SettingsRow } from '@/components/klarhimmel/ui/settings';

export default function Example() {
  return (
    <Theme theme="brand">
      <SettingsGroup title="Notifications" description="What we email you about.">
        <SettingsRow label="Plan" description="Billed monthly.">Starter</SettingsRow>
      </SettingsGroup>
    </Theme>
  );
}
```

## Import

- **CLI**

  ```
  npx shadcn add @klarhimmel/settings
  ```
- **Import**

  ```
  import { SettingsGroup, SettingsRow } from '@/components/klarhimmel/ui/settings';
  ```

- **Files**: settings.tsx, in components/klarhimmel/ui/. With it: button, card, input, switch, theme, utils.
- **Render in**: Render it inside <Theme>, once near the root of your app. Tokens and fonts are scoped to it, so outside it the component is unstyled.

## Props

- **SettingsGroup.title**: The group heading; also names the section.
- **SettingsGroup.description**: One line under the heading.
- **SettingsGroup.className**: Extra classes, merged after the component's own.
- **SettingsGroup.children**: The rows.
- **SettingsRow.label**
- **SettingsRow.description**: One line under the heading.
- **SettingsRow.id**
- **SettingsRow.className**: Extra classes, merged after the component's own.
- **SettingsRow.children**: The rows.

[Previous](/components/switch)

[Next](/components/settings-row)
