Uai

applicationsettings-page.tsx

Color theme

block · 92/108

Settings Page

Grouped settings with edited markers, inline validation, a floating save state, and a quiet danger zone.

Install

Install manuallyView source on GitHub

Composes

  • settings-page.tsx13
  • confirmation-dialog.tsx9
  • form-field.tsx4
  • unsaved-changes-bar.tsx4

Accessibility5 checks

  • Each settings group is a section named by its h3 title and described by its summary text.
  • Fields are Form Fields: visible labels, errors announced with role="alert" and linked with aria-describedby. Required fields keep the native required state; only optional ones are marked visually.
  • The Edited marker is part of the label while a field differs from the saved value, and hidden from assistive tech otherwise.
  • The save bar is a labelled region whose message is a live status, or an alert when saving fails. Save stays enabled with invalid fields: pressing it moves focus to the first one.
  • Destructive actions open a modal alert dialog that traps focus, focuses Cancel, can require a typed phrase, and returns focus to the trigger.
canvasvariant="stacked"application
Application surfaces

Workspace settings

These details appear on invoices, receipts, and customer emails.

General

The name and contact address customers see.

Replies to order emails go here.

uai.app/northwind

Danger zone

Permanent actions. We ask you to confirm first.

Delete workspace

Removes every order, product, and team member. This can’t be undone.

2 unsaved changes

settings page layout

Code example

usage.tsx
"use client";import { CircleAlert } from "lucide-react";import { useState } from "react";import {  SettingsPage,  SettingsPageConfirm,  SettingsPageDescription,  SettingsPageField,  SettingsPageFieldEdited,  SettingsPageHeader,  SettingsPageSaveBar,  SettingsPageSection,  SettingsPageSectionContent,  SettingsPageSectionDescription,  SettingsPageSectionHeader,  SettingsPageSectionTitle,  SettingsPageTitle,  type SettingsPageVariant,} from "@/components/uai/settings-page";import {  ConfirmationDialogActions,  ConfirmationDialogCancel,  ConfirmationDialogConfirm,  ConfirmationDialogContent,  ConfirmationDialogDescription,  ConfirmationDialogImpact,  ConfirmationDialogInput,  ConfirmationDialogTitle,  ConfirmationDialogTrigger,} from "@/components/ui/uai/confirmation-dialog";import {  FormFieldDescription,  FormFieldError,  FormFieldInput,  FormFieldLabel,} from "@/components/ui/uai/form-field";import {  UnsavedChangesBarActions,  UnsavedChangesBarDiscard,  UnsavedChangesBarMessage,  UnsavedChangesBarSave,} from "@/components/ui/uai/unsaved-changes-bar";type Settings = { name: string; email: string; url: string };const saved0: Settings = {  name: "Northwind Goods",  email: "support@northwind.example",  url: "northwind-goods-co",};// Opens dirty and invalid, as in the design mockup.const draft0: Settings = { ...saved0, name: "Northwind Goods Co.", url: "northwind" };const taken = ["northwind", "northwind-co"];export function SettingsPagePreview({ variant = "stacked" }: { variant?: SettingsPageVariant }) {  const [saved, setSaved] = useState(saved0);  const [draft, setDraft] = useState(draft0);  const [status, setStatus] = useState<"idle" | "saving" | "error">("idle");  const [attempts, setAttempts] = useState(0);  const [blocked, setBlocked] = useState(false);  const [deleted, setDeleted] = useState(false);  const edited = {    name: draft.name !== saved.name,    email: draft.email !== saved.email,    url: draft.url !== saved.url,  };  const changes = Object.values(edited).filter(Boolean).length;  const invalid = {    name: draft.name.trim().length === 0,    email: !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(draft.email),    url: !/^[a-z0-9-]+$/.test(draft.url) || (edited.url && taken.includes(draft.url)),  };  const invalidCount = Object.values(invalid).filter(Boolean).length;  function save() {    setStatus("saving");    // The first save fails so the preview shows recovery; Retry then succeeds.    window.setTimeout(() => {      if (attempts === 0) return setStatus("error");      setSaved(draft);      setStatus("idle");    }, 900);    setAttempts(attempts + 1);  }  return (    <SettingsPage variant={variant}>      <SettingsPageHeader>        <SettingsPageTitle>Workspace settings</SettingsPageTitle>        <SettingsPageDescription>          These details appear on invoices, receipts, and customer emails.        </SettingsPageDescription>      </SettingsPageHeader>      <SettingsPageSection>        <SettingsPageSectionHeader>          <SettingsPageSectionTitle>General</SettingsPageSectionTitle>          <SettingsPageSectionDescription>            The name and contact address customers see.          </SettingsPageSectionDescription>        </SettingsPageSectionHeader>        <SettingsPageSectionContent>          <SettingsPageField            required            edited={edited.name}            invalid={invalid.name}            value={draft.name}            onValueChange={(name) => setDraft({ ...draft, name })}          >            <FormFieldLabel>              Workspace name <SettingsPageFieldEdited />            </FormFieldLabel>            <FormFieldInput autoComplete="organization" />            <FormFieldError>              <CircleAlert aria-hidden="true" />              Enter a workspace name.            </FormFieldError>          </SettingsPageField>          <SettingsPageField            required            edited={edited.email}            invalid={invalid.email}            value={draft.email}            onValueChange={(email) => setDraft({ ...draft, email })}          >            <FormFieldLabel>              Support email <SettingsPageFieldEdited />            </FormFieldLabel>            <FormFieldInput type="email" autoComplete="email" />            <FormFieldDescription>Replies to order emails go here.</FormFieldDescription>            <FormFieldError>              <CircleAlert aria-hidden="true" />              Enter an email address such as help@northwind.example.            </FormFieldError>          </SettingsPageField>          <SettingsPageField            required            edited={edited.url}            invalid={invalid.url}            value={draft.url}            onValueChange={(url) => setDraft({ ...draft, url })}          >            <FormFieldLabel>              Workspace URL <SettingsPageFieldEdited />            </FormFieldLabel>            <FormFieldInput autoComplete="off" spellCheck={false} />            <FormFieldDescription>uai.app/{draft.url || "your-workspace"}</FormFieldDescription>            <FormFieldError>              <CircleAlert aria-hidden="true" />              {taken.includes(draft.url)                ? "That URL is taken. Try northwind-goods."                : "Use lowercase letters, numbers, and dashes."}            </FormFieldError>          </SettingsPageField>        </SettingsPageSectionContent>      </SettingsPageSection>      <SettingsPageSection tone="danger">        <SettingsPageSectionHeader>          <SettingsPageSectionTitle>Danger zone</SettingsPageSectionTitle>          <SettingsPageSectionDescription>            Permanent actions. We ask you to confirm first.          </SettingsPageSectionDescription>        </SettingsPageSectionHeader>        <SettingsPageSectionContent>          <div>            <strong>Delete workspace</strong>            <p>              {deleted                ? "Workspace scheduled for deletion. Contact support within 30 days to restore it."                : "Removes every order, product, and team member. This can’t be undone."}            </p>          </div>          <SettingsPageConfirm>            <ConfirmationDialogTrigger disabled={deleted}>              Delete workspace…            </ConfirmationDialogTrigger>            <ConfirmationDialogContent>              <ConfirmationDialogTitle>Delete Northwind Goods?</ConfirmationDialogTitle>              <ConfirmationDialogDescription>                <p style={{ margin: 0 }}>This permanently removes:</p>                <ConfirmationDialogImpact>                  <li>4,812 orders and their invoices</li>                  <li>312 products and 1,240 images</li>                  <li>Access for 9 team members</li>                </ConfirmationDialogImpact>              </ConfirmationDialogDescription>              <ConfirmationDialogInput match="northwind-goods" />              <ConfirmationDialogActions>                <ConfirmationDialogCancel />                <ConfirmationDialogConfirm onClick={() => setDeleted(true)}>                  Delete workspace                </ConfirmationDialogConfirm>              </ConfirmationDialogActions>            </ConfirmationDialogContent>          </SettingsPageConfirm>        </SettingsPageSectionContent>      </SettingsPageSection>      <SettingsPageSaveBar        dirty={changes > 0}        status={status}        warnBeforeUnload={false}        onSave={save}        onDiscard={() => {          setDraft(saved);          setStatus("idle");          setBlocked(false);        }}      >        <UnsavedChangesBarMessage>          {status === "error" ? (            "Couldn’t save. Your changes are still here."          ) : blocked && invalidCount > 0 ? (            `Fix ${invalidCount} ${invalidCount === 1 ? "field" : "fields"} to save`          ) : changes === 0 ? (            // The bar stays up briefly after a save to confirm it; there is nothing to count.            "All changes saved"          ) : (            <span              key={changes}              className="tabular-nums motion-safe:animate-in motion-safe:fade-in-0 motion-safe:slide-in-from-bottom-[3px] motion-safe:duration-200 motion-safe:ease-out-quint"            >              {changes} unsaved {changes === 1 ? "change" : "changes"}            </span>          )}        </UnsavedChangesBarMessage>        <UnsavedChangesBarActions>          <UnsavedChangesBarDiscard />          <UnsavedChangesBarSave onClick={() => setBlocked(invalidCount > 0)}>            {status === "error" ? "Retry" : "Save changes"}          </UnsavedChangesBarSave>        </UnsavedChangesBarActions>      </SettingsPageSaveBar>    </SettingsPage>  );}

Manual installation

settings-page.tsx

Loading component source…

esc
ThinkingAI
MessageAI
CitationAI
AttachmentAI
Tool CallAI
Response StatusAI
Run SummaryAI
Conversation ThreadAI · Block
Research SessionAI · Block
File AnalysisAI · Block
Agent RunAI · Block
Approval CardFeedback
Empty StateFeedback
Status BannerFeedback
Progress SummaryFeedback
Inline FeedbackFeedback
Confirmation DialogFeedback
Activity TimelineFeedback
Skeleton GroupFeedback
Prompt ComposerForms
Form FieldForms
Search FieldForms
Filter BarForms
File UploadForms
Date Range PickerForms
Form Error SummaryForms
Unsaved Changes BarForms
Step IndicatorForms
Task ListData Display
Data Table ToolbarData Display
Metric CardData Display
Description ListData Display
Comparison TableData Display
Kanban BoardData Display
Calendar ViewData Display
Audit LogData Display
App HeaderNavigation
App SidebarNavigation
Breadcrumb TrailNavigation
Page TabsNavigation
Command MenuNavigation
Split PaneNavigation
Sign-in CardAuthentication
Sign-up CardAuthentication
Password RecoveryAuthentication
Code VerificationAuthentication · Block
Onboarding WizardAuthentication · Block
Workspace SetupAuthentication · Block
Coupon FieldCommerce
Quantity PickerCommerce
Cart ItemCommerce
Price SummaryCommerce
Order StatusCommerce
Product DetailCommerce · Block
Product ListingCommerce · Block
Cart DrawerCommerce · Block
CheckoutCommerce · Block
Order TrackingCommerce · Block
Subscription ManagementCommerce · Block
Announcement BarMarketing
Pricing ToggleMarketing
Testimonial CardMarketing
Product GalleryMarketing
Trust PanelMarketing
Newsletter FormMarketing
Hero SectionMarketing · Block
Feature ShowcaseMarketing · Block
Pricing SectionMarketing · Block
Testimonials SectionMarketing · Block
FAQ SectionMarketing · Block
Call to ActionMarketing · Block
Waitlist SectionMarketing · Block
Contact SectionMarketing · Block
Author CardContent
CommentContent
Reaction BarContent
Share MenuContent
Changelog EntryContent
Article PageContent · Block
Documentation PageContent · Block
Changelog PageContent · Block
Comment ThreadContent · Block
Community FeedContent · Block
Public ProfileContent · Block
Map FrameMaps
Map ControlsMaps
Map MarkerMaps
Map LegendMaps
Place CardMaps
Route SummaryMaps
Dashboard ShellApplication · Block
Settings PageApplication · Block
Profile PageApplication · Block
Team ManagementApplication · Block
Notification CenterApplication · Block
Billing PortalApplication · Block
Search ResultsApplication · Block
Resource ManagerOperations · Block
Data ExplorerOperations · Block
Import WorkflowOperations · Block
Approval QueueOperations · Block
Audit Log ViewerOperations · Block
Incident DashboardOperations · Block
Report BuilderOperations · Block
Document FieldBrazil
CEP FieldBrazil
Pix PaymentBrazil
Installment PickerBrazil