# Account and personal settings

Let a person change who they are in the app, how it reaches them and where they are signed in.

For: Every signed-in person.

Web page: https://candor.themethodic.com/screens/account-settings

## Layouts

### Sections down the side

Pick it when: The default: a handful of groups, one open at a time.

Layout: Grouped sections down the side; the open one, such as profile, beside them.

Items:

- **Settings layout** (`settings-layout`, Pro; https://candor.themethodic.com/docs/settings-layout.md): Settings: grouped sections down the side and the open one beside them.
- **Profile settings** (`profile-settings`, Pro; https://candor.themethodic.com/docs/profile-settings.md): Name, email (changed through the sign-in provider, which the field says), time zone and theme.
- **Notification preferences** (`notification-preferences`, Pro; https://candor.themethodic.com/docs/notification-preferences.md): What reaches the person, by kind and channel.
- **Switch** (`switch`, free; https://candor.themethodic.com/docs/switch.md): A setting that is on or off.

```bash
npx candor-ui add settings-layout profile-settings notification-preferences switch
```

### Devices and sound

Pick it when: People sign in from several places and the product makes sound.

Layout: A list of where the person is signed in, with a sound control below it.

Items:

- **Device sessions** (`device-sessions`, Pro; https://candor.themethodic.com/docs/device-sessions.md): Everywhere the person is signed in, how each session signed in, where and when it was last used.
- **Sound setting** (`sound-setting`, Pro; https://candor.themethodic.com/docs/sound-setting.md): Sounds: Off, When I'm away or Always, each event with the visible cue it comes with.
- **Locked** (`locked`, free; https://candor.themethodic.com/docs/locked.md): A setting this person can't change shows its value and says why.

```bash
npx candor-ui add device-sessions sound-setting locked
```

## Rules that matter most here

- **A control that can't be used says why** (https://candor.themethodic.com/principles#locked-says-why): An email the sign-in provider owns is shown, and the field says where it is changed.
- **Say what can and can't be undone** (https://candor.themethodic.com/principles#say-what-can-be-undone): Signing out another device says what it ends and that the person can sign in again.

## Brief for a coding agent

Paste this to the agent that builds the screen.

```text
Build account settings with Candor UI.
Put the sections in SettingsLayout: ProfileSettings, NotificationPreferences, SoundSetting and DeviceSessions.
ProfileSettings shows the email but does not edit it; the field says it is changed through the sign-in provider.
A sound is never the only signal: SoundSetting pairs each event with a visible cue.
DeviceSessions marks the current session and says how each one signed in. Ending one says what it ends.
Wrap a setting this person can't change in Locked so it shows its value and why.

Start from the "Sections down the side" layout: Grouped sections down the side; the open one, such as profile, beside them.
Candor items: settings-layout (https://candor.themethodic.com/docs/settings-layout.md), profile-settings (https://candor.themethodic.com/docs/profile-settings.md), notification-preferences (https://candor.themethodic.com/docs/notification-preferences.md), switch (https://candor.themethodic.com/docs/switch.md).
Install: npx candor-ui add settings-layout profile-settings notification-preferences switch
Read each item's docs before using it and take its props from there; don't guess them. Pro and Premium items need the person's licence key, which they add with `npx candor-ui key <key>`; don't ask for it.
```