Skip to contentKino
Skip to Content

Settings page

An app's settings. The sections in a list beside the page, every one in one form, so a change anywhere raises the Save bar and Save sends them all. A profile photo you crop, notifications by channel, and a danger zone.

Preview

A person’s profile, preferences and notifications in one form. Change anything in any section and the Save bar rises; Save sends them all. An email at taken.com is turned down by the server, and brings Profile back from any section.

npx shadcn add https://kinoui.com/r/settings-page.json

Settings

Your profile, how Kino looks for you, and where your notifications go.

Profile

How your team sees you across Kino.

Your details

AO

Shown beside your comments and on issues you own.

Sign-in links and notifications go here.

Danger zone

These can’t be undone.
Sign out of other devices

3 other sessions, the latest 2 hours ago in Lisbon.

Delete account

Your issues and comments stay with the team. Your profile and settings go.

Examples

Workspace

The same parts for a workspace: its name, address and time zone, how members sign in, and deleting it.

npx shadcn add https://kinoui.com/r/settings-page.json

Workspace settings

For everyone in Kino. Only admins can change them.

General

Workspace

kinoui.com/

Your team finds the workspace here.

Cycles start at 9:00 here.

Danger zone

Delete workspace

Every project, issue and file in Kino goes, for all 24 members.

Installation

npx shadcn@latest add https://kinoui.com/r/settings-page.json
Files
lib/reduce-motion.tslib/resize.tslib/run-progress.tslib/highlight.tslib/flow.tslib/refs.tslib/roll.tsxcomponents/kino/avatar.tsxlib/swap.tsxcomponents/kino/spinner.tsxcomponents/kino/button.tsxlib/scroll.tslib/panel.tsxcomponents/kino/card.tsxcomponents/kino/collapsible.tsxlib/popup.tslib/glide.tsxcomponents/kino/tooltip.tsxlib/cut.tsxlib/announce.tsxlib/notice.tsxlib/settle.tscomponents/kino/confirm-button.tsxcomponents/kino/dialog.tsxcomponents/kino/label.tsxcomponents/kino/field.tsxlib/controllable.tscomponents/kino/alert.tsxcomponents/kino/empty.tsxcomponents/kino/input.tsxlib/track.tscomponents/kino/progress.tsxlib/dates.tslib/field-control.tsxlib/number-format.tslib/uploads.tscomponents/kino/file-input.tsxcomponents/kino/slider.tsxcomponents/kino/image-cropper.tsxcomponents/kino/textarea.tsxcomponents/kino/input-group.tsxcomponents/kino/separator.tsxcomponents/kino/item.tsxcomponents/kino/preferences.tsxlib/keys.tsxlib/refuse.tslib/form-changes.tsxcomponents/kino/save-bar.tsxlib/pill.tscomponents/kino/segmented-control.tsxlib/menu.tsxcomponents/kino/select.tsxlib/choice.tscomponents/kino/switch.tsxcomponents/kino/tabs.tsxcomponents/kino/dropdown-menu.tsxcomponents/kino/theme-switcher.tsxcomponents/kino/settings-page/settings-page.tsxcomponents/kino/settings-page/settings-channel.tsxcomponents/kino/settings-page/settings-photo.tsx
Packages
@base-ui/reactclass-variance-authority

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

SettingsPage

PropTypeDefaultDescription
onSave(values) => unknownPromise<…>NoneSaves the form’s values, by field name. A promise keeps the Save bar saving until it settles; a throw or a rejection says it failed. Return errors by field, such as { email: "…" }, to show them there: a field in a section out of sight brings its section back and takes focus.
onDiscard() => voidNoneRuns after Discard has put every field back, for state the form doesn’t hold.
titleReactNode'Settings'The heading, which also names the form.
descriptionReactNodeNoneThe line under the heading.
heading'h1''h2''h1'The title’s level: h1 on a page of its own, h2 inside a dialog. Sections and groups take the levels under it.
sectionstringNoneThe section shown, when you hold it, such as from the address.
defaultSectionstringNoneThe section it opens on: the first when left out.
onSectionChange(section: string) => voidNoneRuns when the person picks another section.

SettingsNav

PropTypeDefaultDescription
aria-labelstring'Sections'Names the list for a screen reader.

SettingsNavItem

PropTypeDefaultDescription
valuestringNoneThe value of the section it shows.
iconReactNodeNoneBefore the label, sized by the item.

SettingsSection

PropTypeDefaultDescription
valuestringNoneNames the section for its tab, section and onSectionChange.
titlestringNoneThe section’s heading.
descriptionReactNodeNoneThe line under the heading.

SettingsGroup

PropTypeDefaultDescription
titleReactNodeNoneThe group’s heading.
descriptionReactNodeNoneThe line under the heading.
variant'default''destructive''default'destructive for the danger zone: actions that can’t be taken back.

SettingsRow

PropTypeDefaultDescription
namestringNoneWhat Save sends the value under.
labelReactNodeNoneThe setting’s name.
descriptionReactNodeNoneWhat the setting does, under the label.
layout'auto''row''column''auto'Where the control sits: beside the label when the group is 28rem wide or more (auto), always beside it, as a Switch does (row), or under it, as a text field does (column).
groupbooleanfalseFor a control made of options, such as a Segmented control: the label names the group, and each option keeps its own name.

SettingsAction

PropTypeDefaultDescription
titleReactNodeNoneWhat the action does.
descriptionReactNodeNoneWhat follows from it.

SettingsPhoto

PropTypeDefaultDescription
namestring'photo'What Save sends the photo under.
defaultValuestringnullnullThe saved photo’s address, or null for none.
fallbackReactNodeNoneShown without a photo: the person’s initials.
altstringNoneThe person’s name, for the cropper’s picture.
labelReactNode'Photo'The setting’s name.
descriptionReactNodeNoneWhere the photo shows.

SettingsChannel

PropTypeDefaultDescription
namestringNoneWhat Save sends the channel’s switch under. Keep it apart from other fields, such as notifications.email beside a profile’s email.
labelReactNodeNoneThe channel’s name.
descriptionReactNodeNoneWhere it sends them, such as the address.
iconReactNodeNoneIn a tile before the label.
defaultCheckedbooleantrueWhether the channel is on, as it was saved.

CSS variables

VariableSet it onDefaultDescription
--settings-page-topSettingsPage, or anything above it1.5remHow far below the top of the view the list of sections sticks as the page scrolls, and where a section picked from far down stops. Set it under a header that stays at the top.

Accessibility

  • The list of sections is a Tabs list: the arrow keys move between sections, and Tab goes from the list into the section shown.
  • Each group is named by its title, and a channel’s switches by the channel’s, so a screen reader hears where a setting sits.
  • A row of options, such as the theme, names the group by the row’s label and each option by its own.
  • A field turned down, on Save or by the server, takes focus, and its section comes back first when it was out of sight. The Save bar never covers the field in use.
  • The photo’s label focuses its upload, and the cropper is a dialog that takes focus and gives it back.