# Particle Password

A password field whose reveal is a burst: each masking dot pops into a spray of particles that arc out and gather into the real letter, one character after the next, and hiding sends the letters back into their dots.

- Page and source: https://uibrik.com/components/particle-password
- Install (Pro, needs a license key, see https://uibrik.com/docs/pro): `npx shadcn@latest add @uibrik-pro/particle-password`
- Packages: none beyond React
- Import: `import { ParticlePassword } from "@/components/uibrik/particle-password/particle-password"`

Where to use the Particle Password React component:

- **Sign-in and sign-up**: Checking a typed password becomes a small moment instead of a flicker between dots and text. Pairs with [Auth Forms](https://uibrik.com/components/auth-forms) and [Password Strength](https://uibrik.com/components/password-strength).
- **API keys and secrets**: Revealing a stored key or token one character at a time makes it feel deliberate. Pairs with [Copy Button](https://uibrik.com/components/copy-button).
- **Settings and billing**: Card security codes and PINs can sit masked and burst into view on request. Pairs with [Settings Page](https://uibrik.com/components/settings-page) and [Card Input](https://uibrik.com/components/card-input).

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| duration | `number` | `620` | Length of one character's flight. |
| spread | `number` | `16` | How far particles fly out before they gather. |
| stagger | `number` | `26` | Delay between one character and the next. |
| color | `string` | `""` | Particle colour mid-flight; empty keeps the text colour. |
| size | `"sm" \| "md" \| "lg"` | `"md"` | Height, padding and text size. |
| radius | `number` | `12` | Corner radius. |
| value | `string` |  | Controlled value. |
| defaultValue | `string` | `""` | Starting value when uncontrolled. |
| onChange | `(value: string) => void` |  | Called with the new value. |
| visible | `boolean` |  | Controlled: whether the password shows as text. |
| defaultVisible | `boolean` | `false` | Starting visibility when uncontrolled. |
| onVisibleChange | `(visible: boolean) => void` |  | Called when the eye button is pressed. |
| placeholder | `string` | `"Password"` | Placeholder text. |
| label | `string` | `"Password"` | Accessible name for the field. |
| name | `string` |  | Form field name. |
| autoComplete | `string` | `"current-password"` | Use "new-password" on sign-up forms. |
| disabled | `boolean` | `false` | Disables the field and the button. |
| className | `string` |  | Classes for the wrapper. |
