Screens / Knowledge and setup

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.

Markdown

2 ways to lay it out

1. Sections down the side

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

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

Settings layoutProSettings: grouped sections down the side and the open one beside them.
Profile settingsProName, email (changed through the sign-in provider, which the field says), time zone and theme.
Notification preferencesProWhat reaches the person, by kind and channel.
SwitchFreeA setting that is on or off.

Install sections down the side

Pro and Premium items need a licence key; free ones install as they are.

2. Devices and sound

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

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

Device sessionsProEverywhere the person is signed in, how each session signed in, where and when it was last used.
Sound settingProSounds: Off, When I'm away or Always, each event with the visible cue it comes with.
LockedFreeA setting this person can't change shows its value and says why.

Install devices and sound

Pro and Premium items need a licence key; free ones install as they are.

Rules that matter most here

A control that can't be used 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
Signing out another device says what it ends and that the person can sign in again.

Brief for a coding agent

Paste this into the agent that builds the screen. The docs MCP server returns the same text from get_screen.

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.