react-canvas-draw, react-signature-canvas, react-signature-pad, and react-signature-pad-wrapper are React components designed to capture handwritten signatures or freeform drawings using the HTML5 canvas element. These libraries abstract the complexities of canvas event handling, stroke rendering, and image export, providing developers with ready-to-use signature pads. While react-canvas-draw offers general drawing capabilities with undo/redo features, the other three are specialized for signature capture and are built on top of the battle-tested signature_pad JavaScript library, differing mainly in their API design, additional utilities, and maintenance status.
When you need to capture user signatures or freehand drawings in a React application, several npm packages aim to solve this problem. While they all use the HTML <canvas> element under the hood, their APIs, feature sets, and maintenance status differ significantly. Let’s break down each option so you can choose the right tool for your project.
All four libraries wrap the native HTML5 canvas API to provide a drawing surface optimized for signature capture. They typically expose methods to clear the canvas, get image data (as PNG or base64), and control stroke appearance. However, their implementation strategies and extensibility vary.
react-canvas-drawThis package provides a general-purpose drawing canvas that can be configured for signatures but isn’t signature-specific. It supports undo/redo, brush radius control, and background images.
import CanvasDraw from "react-canvas-draw";
function App() {
return (
<CanvasDraw
brushRadius={2}
lazyRadius={0}
hideGrid={true}
canvasWidth={500}
canvasHeight={200}
/>
);
}
Note: The official npm page shows no recent updates, and the GitHub repository appears inactive. Use with caution in new projects.
react-signature-canvasA lightweight wrapper around the popular signature_pad library by Szymon Nowak. It focuses exclusively on signature capture with minimal overhead.
import SignatureCanvas from 'react-signature-canvas';
function App() {
const sigCanvas = useRef({});
const clear = () => sigCanvas.current.clear();
const trim = () => sigCanvas.current.getTrimmedCanvas().toDataURL('image/png');
return (
<div>
<SignatureCanvas
ref={sigCanvas}
canvasProps={{ width: 500, height: 200 }}
/>
<button onClick={clear}>Clear</button>
</div>
);
}
This package delegates most logic to signature_pad, which is actively maintained and well-tested.
react-signature-padAnother wrapper around signature_pad, but with a slightly different API design. It uses props instead of refs for common operations.
import { SignaturePad } from 'react-signature-pad';
function App() {
const [signaturePad, setSignaturePad] = useState(null);
const handleEnd = () => {
if (signaturePad) {
console.log(signaturePad.toDataURL());
}
};
return (
<SignaturePad
ref={setSignaturePad}
onEnd={handleEnd}
canvasProps={{ width: 500, height: 200 }}
/>
);
}
The package appears functional but has less documentation than alternatives.
react-signature-pad-wrapperThis is a higher-level wrapper that adds convenience features like built-in clear buttons, validation helpers, and TypeScript support on top of signature_pad.
import SignaturePadWrapper from 'react-signature-pad-wrapper';
function App() {
const [signature, setSignature] = useState('');
const handleSave = (dataURL) => {
setSignature(dataURL);
};
return (
<SignaturePadWrapper
onEnd={handleSave}
canvasProps={{ width: 500, height: 200 }}
clearButton={<button>Clear Signature</button>}
/>
);
}
It’s designed to reduce boilerplate for common signature workflows.
react-canvas-draw: Built-in undo/redo via undo() and redo() methods.
// Requires ref access
canvasRef.current.undo();
react-signature-canvas: No native undo. You’d need to implement it using fromData() and storing history yourself.
react-signature-pad: No undo support out of the box.
react-signature-pad-wrapper: No undo functionality.
If your app requires undo capability, react-canvas-draw is the only option among these four — but consider its maintenance status.
All packages support exporting as PNG/base64, but the method differs:
react-canvas-draw:
const data = canvasRef.current.getDataURL();
react-signature-canvas:
const data = sigCanvas.current.getTrimmedCanvas().toDataURL();
react-signature-pad:
const data = signaturePad.toDataURL();
react-signature-pad-wrapper:
// Via onEnd callback or by accessing internal ref
Note: Only react-signature-canvas and wrappers based on signature_pad support getTrimmedCanvas(), which crops whitespace — crucial for clean signature storage.
react-canvas-draw: Requires manual handling of window resize events.
react-signature-canvas: Responsive by default when container size changes; includes touch event support.
react-signature-pad: Inherits responsive behavior from signature_pad.
react-signature-pad-wrapper: Adds automatic resizing logic on top of signature_pad.
For mobile-first applications, the signature_pad-based solutions generally provide better out-of-the-box touch handling.
Based on official npm and GitHub sources:
react-canvas-draw: Last published over 3 years ago. Repository shows no recent activity. Not recommended for new projects.
react-signature-canvas: Actively maintained, with regular updates aligned with signature_pad releases.
react-signature-pad: Appears functional but has sparse documentation and infrequent updates.
react-signature-pad-wrapper: Actively maintained, with clear TypeScript definitions and recent feature additions.
Avoid react-canvas-draw unless you’re maintaining a legacy codebase that already depends on it.
You need a clean signature pad with clear button and trimmed output for legal documents.
react-signature-canvas or react-signature-pad-wrapperYou’re building a sketching tool where users expect undo functionality.
react-canvas-draw — but consider forking or migrating to a more modern canvas library like roughjs or fabric.js with React bindings.You need full type safety and long-term maintainability.
react-signature-pad-wrapper (includes .d.ts files) or react-signature-canvas (community types available via DefinitelyTyped).| Feature | react-canvas-draw | react-signature-canvas | react-signature-pad | react-signature-pad-wrapper |
|---|---|---|---|---|
Based on signature_pad | ❌ | ✅ | ✅ | ✅ |
| Trimmed output | ❌ | ✅ | ✅ | ✅ |
| Undo/Redo | ✅ | ❌ | ❌ | ❌ |
| Active maintenance | ❌ (deprecated) | ✅ | ⚠️ (minimal activity) | ✅ |
| Built-in clear button | ❌ | ❌ | ❌ | ✅ |
| TypeScript support | ❌ | ⚠️ (via @types) | ⚠️ | ✅ |
For new projects, avoid react-canvas-draw due to inactivity. Between the remaining three:
react-signature-canvas if you want a minimal, direct wrapper with full control.react-signature-pad-wrapper if you prefer convenience features (like built-in clear buttons and validation helpers) and strong TypeScript support.react-signature-pad only if its specific API fits your architecture — but verify compatibility thoroughly.Remember: All signature_pad-based solutions benefit from the robustness of the underlying library, which handles edge cases like high-DPI displays, touch events, and smooth stroke rendering. That shared foundation makes them more reliable than standalone implementations.
Choose react-signature-canvas when you need a lightweight, direct wrapper around the proven signature_pad library with minimal abstraction. It gives you full control over the canvas instance via refs and is ideal if you prefer to build your own UI controls (like clear buttons) and handle responsiveness manually.
Opt for react-signature-pad-wrapper when you want a batteries-included solution with built-in UI elements (like clear buttons), automatic canvas resizing, TypeScript support, and validation helpers. It reduces boilerplate for common signature workflows while leveraging the reliability of the underlying signature_pad library.
Avoid react-canvas-draw for new projects — it hasn't been actively maintained in years and lacks signature-specific features like automatic whitespace trimming. Only consider it if you're maintaining an existing codebase that already depends on it and requires undo/redo functionality not easily replicated elsewhere.
Consider react-signature-pad if its prop-based API aligns with your component design patterns, but verify its compatibility and maintenance status carefully. It offers core signature functionality but provides less documentation and fewer convenience features compared to alternatives, making it a riskier choice for production applications.
A React wrapper component around signature_pad.
Originally, this was just an unopinionated fork of react-signature-pad that did not impose any styling or wrap any other unwanted elements around your canvas -- it's just a wrapper around a single canvas element!
Hence the naming difference.
Nowadays, this repo / library has significantly evolved, introducing new features, fixing various bugs, and now wrapping the upstream signature_pad to have its updates and bugfixes baked in.
This fork also allows you to directly pass props to the underlying canvas element, has new, documented API methods you can use, has new, documented props you can pass to it, has a live demo, has a CodeSandbox playground, has 100% test coverage, and is written in TypeScript.
npm i -S react-signature-canvas
import React from 'react'
import { createRoot } from 'react-dom/client'
import SignatureCanvas from 'react-signature-canvas'
createRoot(
document.getElementById('my-react-container')
).render(
<SignatureCanvas penColor='green'
canvasProps={{width: 500, height: 200, className: 'sigCanvas'}} />,
)
The props of SignatureCanvas mainly control the properties of the pen stroke used in drawing. All props are optional.
velocityFilterWeight : number, default: 0.7minWidth : number, default: 0.5maxWidth : number, default: 2.5minDistance: number, default: 5dotSize : number or function,
default: () => (this.minWidth + this.maxWidth) / 2penColor : string, default: 'black'throttle: number, default: 16There are also two callbacks that will be called when a stroke ends and one begins, respectively.
onEnd : functiononBegin : functionAdditional props are used to control the canvas element.
canvasProps: object
<canvas /> elementbackgroundColor : string, default: 'rgba(0,0,0,0)'
clear convenience method (which itself is called internally during resizes)clearOnResize: bool, default: true
Of these props, all, except for canvasProps and clearOnResize, are passed through to signature_pad as its options.
signature_pad's internal state is automatically kept in sync with prop updates for you (via a componentDidUpdate hook).
All API methods require a ref to the SignatureCanvas in order to use and are instance methods of the ref.
import React, { useRef } from 'react'
import SignatureCanvas from 'react-signature-canvas'
function MyApp() {
const sigCanvas = useRef(null);
return <SignatureCanvas ref={sigCanvas} />
}
isEmpty() : boolean, self-explanatoryclear() : void, clears the canvas using the backgroundColor propfromDataURL(base64String, options) : void, writes a base64 image to canvastoDataURL(mimetype, encoderOptions): base64string, returns the signature image as a data URLfromData(pointGroupArray): void, draws signature image from an array of point groupstoData(): pointGroupArray, returns signature image as an array of point groupsoff(): void, unbinds all event handlerson(): void, rebinds all event handlersgetCanvas(): canvas, returns the underlying canvas ref.
Allows you to modify the canvas however you want or call methods such as toDataURL()getTrimmedCanvas(): canvas, creates a copy of the canvas and returns a trimmed version of it, with all whitespace removed.getSignaturePad(): SignaturePad, returns the underlying SignaturePad reference.The API methods are mostly just wrappers around signature_pad's API.
on() and off() will, in addition, bind/unbind the window resize event handler.
getCanvas(), getTrimmedCanvas(), and getSignaturePad() are new.
You can interact with the example in a few different ways:
Run npm start and navigate to http://localhost:1234/.
Hosted locally via the example/ directory
View the live demo here.
Hosted via the gh-pages branch, a standalone version of the code in example/
Play with the CodeSandbox here.
Hosted via the codesandbox-example branch, a slightly modified version of the above.