Change Password

Change password with current/new/confirm fields.

Preview

Open the exact pattern in the real BeeUI Web Showcase. This is a Web runtime preview, not native-device evidence.

Each named state is directly addressable:

The same source is available at apps/showcase/patterns/account-settings/screens/change-password-screen.tsx.

Composition

Principal public BeeUI exports used by this screen: AlertBanner, Box, Button, Field, HStack, PasswordInput, Text, VStack.

The pattern is a composition recipe rather than a new framework layer. Follow the linked component contracts for state, provider, platform and accessibility details.

State and callback contract

The screen is controlled through ChangePasswordScreenProps. User intent crosses the application boundary through onConfirmPasswordChange, onCurrentPasswordChange, onNewPasswordChange, onSubmit, onSuccess; fetching, routing, persistence and side effects remain application-owned.

// from apps/showcase/patterns/account-settings/screens/change-password-screen.tsx
export type ChangePasswordFieldErrors = Partial<
  Record<'currentPassword' | 'newPassword' | 'confirmPassword', string>
>;

export type ChangePasswordScreenProps = {
  confirmPassword: string;
  currentPassword: string;
  fieldErrors?: ChangePasswordFieldErrors;
  newPassword: string;
  onConfirmPasswordChange: (value: string) => void;
  onCurrentPasswordChange: (value: string) => void;
  onNewPasswordChange: (value: string) => void;
  onSubmit: () => void;
  onSuccess?: () => void;
  saving?: boolean;
  serverError?: string;
  success?: boolean;
};

Common product states such as loading, success, empty, error, permission-like recovery, filtering/search/selection or pagination are represented only where the actual screen source exposes them. The pattern docs do not invent backend states that the fixture does not render.

Responsive contract

Read from the screen file and the 1 pattern-local file in its runtime import closure, direct and transitive: account-settings/screens/change-password-screen.tsx, account-settings/components/settings-screen-shell.tsx. Every fact below is scoped to those files and to nothing else.

BeeUI layout primitives rendered: Box (account-settings/components/settings-screen-shell.tsx; account-settings/screens/change-password-screen.tsx, only when success is false), HStack (account-settings/screens/change-password-screen.tsx, only when success is false), KeyboardAwareScreen (account-settings/components/settings-screen-shell.tsx, only when keyboardAware is true), Screen (account-settings/components/settings-screen-shell.tsx, only when keyboardAware is false), VStack (account-settings/components/settings-screen-shell.tsx; account-settings/screens/change-password-screen.tsx, only when success is false).
Scroll ownership: ScrollView (account-settings/components/settings-screen-shell.tsx, only when keyboardAware is false).
Horizontal scrolling: no horizontal scroll container in account-settings/screens/change-password-screen.tsx, account-settings/components/settings-screen-shell.tsx.
Width constraint: contentWidth="md" (account-settings/components/settings-screen-shell.tsx, only when keyboardAware is true), max-w-[680px] (account-settings/components/settings-screen-shell.tsx, only when keyboardAware is false).
Breakpoint-prefixed utility classes: none in account-settings/screens/change-password-screen.tsx, account-settings/components/settings-screen-shell.tsx.
Platform-prefixed utility classes: web:py-10 (account-settings/components/settings-screen-shell.tsx).
Platform branching: no Platform.OS or Platform.select call in account-settings/screens/change-password-screen.tsx, account-settings/components/settings-screen-shell.tsx.
Viewport measurement: no useWindowDimensions, Dimensions.get or breakpoint hook in account-settings/screens/change-password-screen.tsx, account-settings/components/settings-screen-shell.tsx.

BeeUI’s mobile-first responsive contract is the framework-level document; the list above states only what this screen’s own files declare, and says nothing about how the composed components behave internally.

Accessibility

Roles this screen sets itself: none set in account-settings/screens/change-password-screen.tsx, account-settings/components/settings-screen-shell.tsx.
Accessibility states and properties it sets itself: none set in account-settings/screens/change-password-screen.tsx, account-settings/components/settings-screen-shell.tsx.
Semantics inherited from composed BeeUI families: AlertBanner (account-settings/screens/change-password-screen.tsx, only when success is false and serverError is true; account-settings/screens/change-password-screen.tsx, only when success is true), Box, Button (account-settings/screens/change-password-screen.tsx, only when success is false; account-settings/screens/change-password-screen.tsx, only when success is true and onSuccess is true), Field (account-settings/screens/change-password-screen.tsx, only when success is false), HStack (account-settings/screens/change-password-screen.tsx, only when success is false), KeyboardAwareScreen (account-settings/components/settings-screen-shell.tsx, only when keyboardAware is true), PasswordInput (account-settings/screens/change-password-screen.tsx, only when success is false), Screen (account-settings/components/settings-screen-shell.tsx, only when keyboardAware is false), Text, VStack — each family’s own page derives the roles and states it sets; they are not restated here.

Touch-target size, focus order, announcements, RTL, large-text and reduced-motion behavior are not derived from this source — see the Accessibility guide for what is and is not covered by evidence. A Web preview does not substitute for VoiceOver/TalkBack runtime evidence.

Application ownership boundary

Intentionally excluded: Password verification and the change mutation.

BeeUI does not take ownership of app routing, authentication/business rules, APIs/data fetching, persistence, form/state frameworks, chart frameworks or backend logic merely because a pattern visually composes those product concepts.

Source ownership

ChangePasswordScreen is Showcase source you copy, not a package export: it is not shipped from any @beemvp/beeui-* package, and the Registry CLI (pnpm beeui list / pnpm beeui add) does not carry pattern screens. Copy apps/showcase/patterns/account-settings/screens/change-password-screen.tsx into your app and adapt it directly. Only the individual BeeUI components it composes (linked above) are available for source ownership through the repository-local Registry workflow; see CLI & source ownership for both the published npx @beemvp/beeui-cli@next path and the repository-local checkout path.