Ballmac UI home

Signature Pad

A responsive pointer signature surface with a full keyboard-accessible typed alternative and undo.

Your signatureDraw or type

Use a pointer to sign; choose Type for keyboard entry.

Installation

$ pnpm dlx shadcn@latest add @ballmac/signature-pad

Usage

import { SignaturePad } from "@/components/ballmac/signature-pad"

The full example is in the Code tab above.

Examples

States and variants

Sign by typingDraw or type

Your typed name is saved as the signature.

API reference

PropTypeDefault
label*

Visible and accessible field label.

string—
value

Controlled signature.

SignatureValue—
defaultValue

Initial signature.

SignatureValue{ mode: "draw", strokes: [] }
onValueChange

Called when a stroke, typed name, or mode changes.

(value: SignatureValue) => void—
name

Native form field name for serialized signature data.

string—
disabled

Disable drawing, typing, and actions.

booleanfalse

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
Tab / Enter / Space / typingSwitches methods, types a name, and clears or undoes the signature

Use with AI

A responsive pointer signature surface with a full keyboard-accessible typed alternative and undo. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Signature Pad (@ballmac/signature-pad) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Capture a signer name or freehand mark

Not for

  • Use a text input when a signature is not required

Registry JSON: https://ui.ballmac.com/r/signature-pad.json

Credits

Free to use in personal and commercial projects.