Uai

authenticationpassword-recovery.tsx

Color theme

component · 45/108

Password Recovery

A controlled recovery workflow with card, split, and compact variants.

Install

Install manuallyView source on GitHub

Anatomy

  • PasswordRecovery
  • PasswordRecoveryAside
  • PasswordRecoveryProgress
  • PasswordRecoveryProgressItem
  • PasswordRecoveryMain
  • PasswordRecoveryHeader
  • PasswordRecoveryTitle
  • PasswordRecoveryDescription
  • PasswordRecoveryStage
  • PasswordRecoveryFields
  • PasswordRecoveryField
  • PasswordRecoveryLabel
  • PasswordRecoveryInput
  • PasswordRecoveryFieldMessage
  • PasswordRecoveryError
  • PasswordRecoverySubmit
  • PasswordRecoveryActions
  • PasswordRecoveryAction
  • PasswordRecoveryPasswordGuide
  • PasswordRecoveryPasswordRequirement
  • PasswordRecoveryFooter

Accessibility7 checks

  • The controlled step renders only the active recovery stage.
  • Request feedback avoids revealing whether an account exists for the submitted email.
  • Submitting exposes busy state and disables fields, actions, and duplicate submission.
  • New-password guidance and validation remain programmatically associated with the field.
  • Expired links use an assertive alert; sent and success states use polite status messages.
  • Recovery progress includes complete, current, and upcoming text in addition to icons.
  • Card, split, and compact variants preserve the same form and keyboard contract.
canvasvariant="card"authentication
Password recovery variant

Code example

usage.tsx
"use client";import { type FormEvent, useEffect, useRef, useState } from "react";import {  PasswordRecovery,  PasswordRecoveryAction,  PasswordRecoveryActions,  PasswordRecoveryAside,  PasswordRecoveryDescription,  PasswordRecoveryError,  PasswordRecoveryField,  PasswordRecoveryFieldMessage,  PasswordRecoveryFields,  PasswordRecoveryFooter,  PasswordRecoveryHeader,  PasswordRecoveryInput,  PasswordRecoveryLabel,  PasswordRecoveryMain,  PasswordRecoveryPasswordGuide,  PasswordRecoveryPasswordRequirement,  PasswordRecoveryProgress,  PasswordRecoveryProgressItem,  PasswordRecoveryStage,  type PasswordRecoveryStatus,  PasswordRecoveryStatus as PasswordRecoveryStatusMessage,  type PasswordRecoveryStep,  PasswordRecoverySubmit,  PasswordRecoveryTitle,  type PasswordRecoveryVariant,} from "@/components/ui/uai/password-recovery";export function PasswordRecoveryPreview({  variant = "card",}: {  variant?: PasswordRecoveryVariant;}) {  const [step, setStep] = useState<PasswordRecoveryStep>("request");  const [status, setStatus] = useState<PasswordRecoveryStatus>("idle");  const [password, setPassword] = useState("Preview123!");  const [confirmation, setConfirmation] = useState("Preview123!");  const timerRef = useRef<number | null>(null);  const passwordValid = password.length >= 8 && /[\d\W]/.test(password);  const passwordsMatch = password === confirmation;  useEffect(    () => () => {      if (timerRef.current) window.clearTimeout(timerRef.current);    },    [],  );  function moveTo(nextStep: PasswordRecoveryStep) {    if (timerRef.current) window.clearTimeout(timerRef.current);    setStatus("idle");    setStep(nextStep);  }  function handleSubmit(event: FormEvent<HTMLFormElement>) {    event.preventDefault();    if (timerRef.current) window.clearTimeout(timerRef.current);    setStatus("submitting");    timerRef.current = window.setTimeout(() => {      if (step === "reset") {        setStatus(passwordValid && passwordsMatch ? "idle" : "error");        if (passwordValid && passwordsMatch) setStep("success");        return;      }      setStatus("idle");      setStep("sent");    }, 800);  }  const progress = {    account: step === "request" ? "current" : "complete",    email:      step === "sent" || step === "expired"        ? "current"        : step === "request"          ? "upcoming"          : "complete",    password: step === "reset" ? "current" : step === "success" ? "complete" : "upcoming",  } as const;  const heading = {    request: "Recover your account",    sent: "Check your inbox",    reset: "Choose a new password",    expired: "Reset link expired",    success: "Password updated",  }[step];  const description = {    request: "Enter the email you use for this workspace.",    sent: "The next step is available from your recovery email.",    reset: "Use a password you have not used for this account before.",    expired: "Request a fresh link to continue securely.",    success: "Your account is ready for you to sign in again.",  }[step];  return (    <div      className={        variant === "split"          ? "w-full max-w-[680px]"          : variant === "compact"            ? "w-full max-w-[320px]"            : "w-full max-w-[400px]"      }    >      <PasswordRecovery variant={variant} step={step} status={status} onSubmit={handleSubmit}>        <PasswordRecoveryAside>          <strong>Reset securely</strong>          <p>Three clear steps keep the recovery path visible.</p>          <PasswordRecoveryProgress aria-label="Recovery progress">            <PasswordRecoveryProgressItem state={progress.account}>              Find account            </PasswordRecoveryProgressItem>            <PasswordRecoveryProgressItem state={progress.email}>              Check email            </PasswordRecoveryProgressItem>            <PasswordRecoveryProgressItem state={progress.password}>              New password            </PasswordRecoveryProgressItem>          </PasswordRecoveryProgress>        </PasswordRecoveryAside>        <PasswordRecoveryMain>          <PasswordRecoveryHeader>            <PasswordRecoveryTitle>{heading}</PasswordRecoveryTitle>            <PasswordRecoveryDescription>{description}</PasswordRecoveryDescription>          </PasswordRecoveryHeader>          <PasswordRecoveryStage when="request">            <PasswordRecoveryFields>              <PasswordRecoveryField>                <PasswordRecoveryLabel>Work email</PasswordRecoveryLabel>                <PasswordRecoveryInput                  name="email"                  type="email"                  autoComplete="email"                  defaultValue="hello@acme.co"                  required                />                <PasswordRecoveryFieldMessage>                  We will not reveal whether an account matches this email.                </PasswordRecoveryFieldMessage>              </PasswordRecoveryField>              <PasswordRecoveryError>                We could not send the reset link. Check your connection and try again.              </PasswordRecoveryError>              <PasswordRecoverySubmit />            </PasswordRecoveryFields>          </PasswordRecoveryStage>          <PasswordRecoveryStage when="sent">            <PasswordRecoveryStatusMessage tone="sent">              <span>                If an account matches <strong>hello@acme.co</strong>, its reset link is on the way.              </span>            </PasswordRecoveryStatusMessage>            <PasswordRecoveryActions>              <PasswordRecoveryAction onClick={() => moveTo("reset")}>                Open preview reset link              </PasswordRecoveryAction>              <PasswordRecoveryAction onClick={() => moveTo("expired")}>                Preview expired link              </PasswordRecoveryAction>              <PasswordRecoveryAction onClick={() => moveTo("request")}>                Use another email              </PasswordRecoveryAction>            </PasswordRecoveryActions>          </PasswordRecoveryStage>          <PasswordRecoveryStage when="reset">            <PasswordRecoveryFields>              <PasswordRecoveryField invalid={status === "error" && !passwordValid}>                <PasswordRecoveryLabel>New password</PasswordRecoveryLabel>                <PasswordRecoveryInput                  name="password"                  revealable                  autoComplete="new-password"                  aria-describedby="preview-reset-password-requirements"                  value={password}                  onChange={(event) => {                    setPassword(event.currentTarget.value);                    if (status === "error") setStatus("idle");                  }}                  required                />                <PasswordRecoveryPasswordGuide id="preview-reset-password-requirements">                  <PasswordRecoveryPasswordRequirement met={password.length >= 8}>                    At least 8 characters                  </PasswordRecoveryPasswordRequirement>                  <PasswordRecoveryPasswordRequirement met={/[\d\W]/.test(password)}>                    One number or symbol                  </PasswordRecoveryPasswordRequirement>                </PasswordRecoveryPasswordGuide>              </PasswordRecoveryField>              <PasswordRecoveryField invalid={status === "error" && !passwordsMatch}>                <PasswordRecoveryLabel>Confirm new password</PasswordRecoveryLabel>                <PasswordRecoveryInput                  name="confirmation"                  revealable                  autoComplete="new-password"                  value={confirmation}                  onChange={(event) => {                    setConfirmation(event.currentTarget.value);                    if (status === "error") setStatus("idle");                  }}                  required                />                {status === "error" && !passwordsMatch ? (                  <PasswordRecoveryFieldMessage>                    Enter the same password in both fields.                  </PasswordRecoveryFieldMessage>                ) : null}              </PasswordRecoveryField>              <PasswordRecoveryError>Review the new password and try again.</PasswordRecoveryError>              <PasswordRecoverySubmit />            </PasswordRecoveryFields>          </PasswordRecoveryStage>          <PasswordRecoveryStage when="expired">            <PasswordRecoveryStatusMessage tone="expired">              This reset link has expired. Request a fresh link to continue.            </PasswordRecoveryStatusMessage>            <PasswordRecoverySubmit />          </PasswordRecoveryStage>          <PasswordRecoveryStage when="success">            <PasswordRecoveryStatusMessage tone="success">              Your password has been updated. You can sign in with it now.            </PasswordRecoveryStatusMessage>            <PasswordRecoveryActions>              <PasswordRecoveryAction onClick={() => moveTo("request")}>                Start over              </PasswordRecoveryAction>            </PasswordRecoveryActions>          </PasswordRecoveryStage>          <PasswordRecoveryFooter>            Remembered it? <a href="#sign-in">Back to sign in</a>          </PasswordRecoveryFooter>        </PasswordRecoveryMain>      </PasswordRecovery>    </div>  );}

Manual installation

password-recovery.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