---
title: "Sign Up Form | Free React & Tailwind Blocks Component | Motion UI"
canonical: "https://blacknest.dev/motion/c/blocks/signup-form"
github_source: "https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/signup-form.tsx"
install_command: "npx motion-ui-skill add signup-form"
dependencies: ["clsx","lucide-react","motion","react","tailwind-merge"]
category: "blocks"
subcategory: "motion"
---

# Sign Up Form

> Composed sign-up form that flags a field only once it is left, then clears the moment it is fixed, with a length-weighted strength meter, password reveal and an animated submit lifecycle.

## Install

```bash
npx motion-ui-skill add signup-form
```

## Dependencies

- `clsx`
- `lucide-react`
- `motion`
- `react`
- `tailwind-merge`

## Usage

```tsx
"use client";

import { useState } from "react";
import { SignUpForm } from "@/components/motion/signup-form";

export function SignUpFormPreview() {
  const [formError, setFormError] = useState<string>();

  return (
    <div className="flex w-full justify-center py-4">
      <SignUpForm
        description="Sign up with taken@example.com to see the failure state."
        errorMessage={formError}
        onSubmit={async (values) => {
          setFormError(undefined);
          await new Promise((resolve) => setTimeout(resolve, 1200));
          if (values.email.toLowerCase().startsWith("taken@")) {
            setFormError("That email is already registered.");
            throw new Error("Email already registered");
          }
        }}
        footer={
          <>
            Already have an account?{" "}
            <button
              type="button"
              className="font-medium text-foreground underline underline-offset-4"
            >
              Sign in
            </button>
          </>
        }
      />
    </div>
  );
}
```

## API Reference

### SignUpForm

| Prop | Type | Default | Required | Description |
| --- | --- | --- | --- | --- |
| `values` | `SignUpValues` | — | No | Controlled values. Omit for uncontrolled. |
| `defaultValues` | `Partial<SignUpValues>` | — | No | — |
| `onValuesChange` | `((values: SignUpValues) => void)` | — | No | — |
| `onSubmit` | `((values: SignUpValues) => void \| Promise<void>)` | — | No | Called with valid values only. Return a promise to drive the button state. |
| `validate` | `((values: SignUpValues) => Partial<Record<keyof SignUpValues, string>>)` | — | No | Replace the built-in rules — return a message per invalid field. |
| `status` | `"error" \| "success" \| "loading" \| "idle"` | — | No | Controlled submit state. Omit to let the form track it. |
| `errorMessage` | `string` | — | No | Form-level failure message, shown above the submit button. |
| `title` | `ReactNode` | `Create your account` | No | — |
| `description` | `ReactNode` | `Start building in under a minute.` | No | — |
| `submitLabel` | `string` | `Create account` | No | — |
| `footer` | `ReactNode` | — | No | — |
| `strengthMeter` | `boolean` | `true` | No | Show the password strength meter. |
| `className` | `string` | — | No | — |
| `classNames` | `SignUpFormClassNames` | — | No | — |

## Source Files

- [components/motion/signup-form.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/signup-form.tsx)
- [components/motion/button/base.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/base.tsx)
- [components/motion/button/index.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/index.tsx)
- [components/motion/button/magnetic.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/magnetic.tsx)
- [components/motion/button/metallic.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/metallic.tsx)
- [components/motion/button/stateful.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/button/stateful.tsx)
- [components/motion/checkbox.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/checkbox.tsx)
- [components/motion/input.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/input.tsx)
- [components/motion/magnetic.tsx](https://github.com/Rkj0123/motion-ui-skill/blob/main/components/motion/magnetic.tsx)
- [lib/ease.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/ease.ts)
- [lib/hooks/use-hover-capable.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/hooks/use-hover-capable.ts)
- [lib/utils.ts](https://github.com/Rkj0123/motion-ui-skill/blob/main/lib/utils.ts)
