
syncfusion-flutter-signature-pad
Implements Syncfusion Flutter SignaturePad (SfSignaturePad) for capturing handwritten signatures and drawings in Flutter apps. Use when implementing digital signatures, document signing, e-signature fields, or touch/stylus drawing surfaces. This skill covers stroke customization, background color, saving signatures as images, and clearing the pad.
- Installs
- 49
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/syncfusion/flutter-ui-components-skills --skill syncfusion-flutter-signature-pad- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads syncfusion-flutter-signature-pad automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Syncfusion Flutter Signature Pad
This skill covers the Syncfusion Flutter SfSignaturePad component, which provides an elegant and intuitive way to capture handwritten signatures or drawings in your Flutter applications. The component offers smooth drawing experience with touch and stylus support, along with powerful customization and export capabilities.
When to Use This Skill
Use this skill when you need to:
- Capture digital signatures for documents, forms, or agreements
- Implement e-signature functionality in approval workflows
- Create signature fields in PDF forms or digital documents
- Build document signing interfaces for contracts, receipts, or legal forms
- Add handwritten input for notes, sketches, or annotations
- Implement signature verification screens in authentication flows
- Create drawing surfaces for simple sketching or markup
- Capture user consent with signature-based authentication
- Build approval systems that require handwritten signatures
- Add signature pads to registration, checkout, or delivery confirmation screens
Component Overview
SfSignaturePad is a Flutter widget that captures smooth, high-quality signatures or drawings through touch or stylus input. It provides a customizable drawing surface with features like stroke customization, background images, minimum stroke validation, and multiple export formats.
Key Features
- Smooth Drawing Experience - Optimized for touch and stylus input with smooth curves
- Stroke Customization - Control stroke color, width, and appearance
- Background Support - Add background colors or images
- Minimum Stroke Validation - Ensure meaningful signatures are captured
- Multiple Export Formats - Convert to image (PNG, JPEG) or save as raw data
- Clear & Reset - Programmatically clear the signature pad
- Read-only Mode - Display signatures without allowing modifications
- Callbacks - Handle draw start, draw, and draw end events
- Transparent Background - Support for transparent signature capture
- High-Quality Output - Export signatures at desired resolution
Documentation and Navigation Guide
Getting Started
📄 Read: references/getting-started.md
- Installation and package setup
- Basic SfSignaturePad implementation
- Package dependencies and imports
- First signature capture example
- Quick setup guide
Component Overview
📄 Read: references/overview.md
- SfSignaturePad widget overview and features
- When to use SignaturePad
- Core capabilities and use cases
- Widget architecture
- Basic configuration
Customization and Styling
📄 Read: references/customization.md
- Stroke color customization
- Stroke width and min/max settings
- Background color and images
- Border and container styling
- Transparent backgrounds
- Visual appearance customization
- Theme integration
Saving and Exporting
📄 Read: references/saving-exporting.md
- Converting signature to image (toImage method)
- Image format options (PNG, JPEG)
- Resolution and quality settings
- Saving signatures to storage
- Converting to Uint8List
- Clearing the signature pad
- Minimum stroke count validation
- Export patterns and best practices
Event Handling
📄 Read: references/callbacks.md
- onDrawStart callback
- onDraw callback
- onDrawEnd callback
- Handling signature events
- Validation during drawing
- Real-time feedback patterns
- Event argument types
Advanced Features
📄 Read: references/advanced-features.md
- Read-only mode for displaying signatures
- Background image support
- Signature validation techniques
- Custom drawing constraints
- Integration with forms
- Signature comparison
- Multi-signature workflows
- Undo/redo implementation patterns
Accessibility
📄 Read: references/accessibility.md
- Screen reader support
- Semantic labels for signature fields
- Keyboard accessibility considerations
- Alternative input methods
- WCAG compliance
- Accessible signature workflows
Quick Start Examples
Basic Signature Pad
import 'package:flutter/material.dart';
import 'package:syncfusion_flutter_signaturepad/signaturepad.dart';
class BasicSignaturePad extends StatelessWidget {
final GlobalKey<SfSignaturePadState> _signaturePadKey = GlobalKey();
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text('Sign Here')),
body: Column(
children: [
Padding(
padding: EdgeInsets.all(16),
child: Container(
decoration: BoxDecoration(
border: Border.all(color: Colors.grey),
),
child: SfSignaturePad(
key: _signaturePadKey,
backgroundColor: Colors.white,
),
),
),
Row(
mainAxisAlignment: MainAxisAlignment.spaceEvenly,
children: [
ElevatedButton(
onPressed: () => _signaturePadKey.currentState!.clear(),
child: Text('Clear'),
),
ElevatedButton(
onPressed: _saveSignature,
child: Text('Save'),
),
],
),
],
),
);
}
Future<void> _saveSignature() async {
final image = await _signaturePadKey.currentState!.toImage();
// Process the image (save to file, upload, etc.)
}
}
Customized Signature Pad
import 'package:flutter/material.dart';
import 'package:syncfusion_flutter_signaturepad/signaturepad.dart';
class CustomSignaturePad extends StatelessWidget {
final GlobalKey<SfSignaturePadState> _signaturePadKey = GlobalKey();
@override
Widget build(BuildContext context) {
return SfSignaturePad(
key: _signaturePadKey,
backgroundColor: Colors.grey[100],
strokeColor: Colors.blue,
minimumStrokeWidth: 1.0,
maximumStrokeWidth: 4.0,
onDrawStart: () {
print('Started drawing');
return true;
},
onDraw: (offset, time) {
print('Drawing at: $offset');
},
onDrawEnd: () {
print('Finished drawing');
},
);
}
}
Signature Pad with Validation
import 'package:flutter/material.dart';
import 'package:syncfusion_flutter_signaturepad/signaturepad.dart';
import 'dart:ui' as ui;
class ValidatedSignaturePad extends StatefulWidget {
@override
_ValidatedSignaturePadState createState() => _ValidatedSignaturePadState();
}
class _ValidatedSignaturePadState extends State<ValidatedSignaturePad> {
final GlobalKey<SfSignaturePadState> _signaturePadKey = GlobalKey();
String _validationMessage = '';
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text('Sign Document')),
body: Column(
children: [
Expanded(
child: Padding(
padding: EdgeInsets.all(16),
child: Container(
decoration: BoxDecoration(
border: Border.all(color: Colors.grey, width: 2),
borderRadius: BorderRadius.circular(8),
),
child: SfSignaturePad(
key: _signaturePadKey,
backgroundColor: Colors.white,
strokeColor: Colors.black,
minimumStrokeWidth: 2.0,
maximumStrokeWidth: 4.0,
),
),
),
),
if (_validationMessage.isNotEmpty)
Padding(
padding: EdgeInsets.all(8),
child: Text(
_validationMessage,
style: TextStyle(color: Colors.red),
),
),
Padding(
padding: EdgeInsets.all(16),
child: Row(
mainAxisAlignment: MainAxisAlignment.spaceEvenly,
children: [
OutlinedButton(
onPressed: _clearSignature,
child: Text('Clear'),
),
ElevatedButton(
onPressed: _saveSignature,
child: Text('Save Signature'),
),
],
),
),
],
),
);
}
void _clearSignature() {
setState(() {
_signaturePadKey.currentState!.clear();
_validationMessage = '';
});
}
Future<void> _saveSignature() async {
// Validate minimum stroke count
if (_signaturePadKey.currentState!.toImage == null) {
setState(() {
_validationMessage = 'Please provide a signature';
});
return;
}
try {
final ui.Image image = await _signaturePadKey.currentState!.toImage(
pixelRatio: 3.0,
);
// Convert to bytes
final byteData = await image.toByteData(format: ui.ImageByteFormat.png);
final bytes = byteData!.buffer.asUint8List();
// Save or upload the signature
print('Signature saved: ${bytes.length} bytes');
setState(() {
_validationMessage = 'Signature saved successfully!';
});
// Navigate or perform next action
} catch (e) {
setState(() {
_validationMessage = 'Error saving signature: $e';
});
}
}
}
Signature Pad with Background Image
import 'package:flutter/material.dart';
import 'package:syncfusion_flutter_signaturepad/signaturepad.dart';
class SignatureWithBackground extends StatelessWidget {
final GlobalKey<SfSignaturePadState> _signaturePadKey = GlobalKey();
@override
Widget build(BuildContext context) {
return Container(
decoration: BoxDecoration(
border: Border.all(color: Colors.grey),
image: DecorationImage(
image: AssetImage('assets/signature_background.png'),
fit: BoxFit.cover,
opacity: 0.3,
),
),
child: SfSignaturePad(
key: _signaturePadKey,
backgroundColor: Colors.transparent,
strokeColor: Colors.blue[900]!,
minimumStrokeWidth: 2.0,
maximumStrokeWidth: 5.0,
),
);
}
}
Common Patterns
Pattern 1: Document Signing Flow
class DocumentSigningFlow extends StatefulWidget {
@override
_DocumentSigningFlowState createState() => _DocumentSigningFlowState();
}
class _DocumentSigningFlowState extends State<DocumentSigningFlow> {
final GlobalKey<SfSignaturePadState> _signaturePadKey = GlobalKey();
bool _hasSignature = false;
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text('Sign Agreement')),
body: Column(
children: [
// Document preview
Expanded(
flex: 2,
child: Container(
padding: EdgeInsets.all(16),
child: Text('Agreement Terms...'),
),
),
// Signature section
Padding(
padding: EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'Your Signature',
style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
),
SizedBox(height: 8),
Container(
height: 200,
decoration: BoxDecoration(
border: Border.all(color: Colors.grey),
borderRadius: BorderRadius.circular(8),
),
child: SfSignaturePad(
key: _signaturePadKey,
backgroundColor: Colors.white,
strokeColor: Colors.black,
minimumStrokeWidth: 2.0,
maximumStrokeWidth: 4.0,
onDrawEnd: () {
setState(() => _hasSignature = true);
},
),
),
],
),
),
// Action buttons
Padding(
padding: EdgeInsets.all(16),
child: Row(
children: [
Expanded(
child: OutlinedButton(
onPressed: _clearSignature,
child: Text('Clear'),
),
),
SizedBox(width: 16),
Expanded(
child: ElevatedButton(
onPressed: _hasSignature ? _submitSignature : null,
child: Text('Submit'),
),
),
],
),
),
],
),
);
}
void _clearSignature() {
setState(() {
_signaturePadKey.currentState!.clear();
_hasSignature = false;
});
}
Future<void> _submitSignature() async {
final image = await _signaturePadKey.currentState!.toImage(pixelRatio: 3.0);
// Submit signature with document
Navigator.pop(context, image);
}
}
Pattern 2: Multiple Signatures Collection
class MultipleSignaturesForm extends StatefulWidget {
@override
_MultipleSignaturesFormState createState() => _MultipleSignaturesFormState();
}
class _MultipleSignaturesFormState extends State<MultipleSignaturesForm> {
final GlobalKey<SfSignaturePadState> _applicantKey = GlobalKey();
final GlobalKey<SfSignaturePadState> _witnessKey = GlobalKey();
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text('Signatures Required')),
body: SingleChildScrollView(
padding: EdgeInsets.all(16),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
_buildSignatureField(
'Applicant Signature',
_applicantKey,
),
SizedBox(height: 24),
_buildSignatureField(
'Witness Signature',
_witnessKey,
),
SizedBox(height: 24),
ElevatedButton(
onPressed: _submitAllSignatures,
child: Text('Submit All'),
),
],
),
),
);
}
Widget _buildSignatureField(String label, GlobalKey<SfSignaturePadState> key) {
return Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(label, style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold)),
SizedBox(height: 8),
Container(
height: 150,
decoration: BoxDecoration(
border: Border.all(color: Colors.grey),
borderRadius: BorderRadius.circular(8),
),
child: SfSignaturePad(
key: key,
backgroundColor: Colors.white,
strokeColor: Colors.blue[900]!,
),
),
TextButton(
onPressed: () => key.currentState!.clear(),
child: Text('Clear'),
),
],
);
}
Future<void> _submitAllSignatures() async {
final applicantImage = await _applicantKey.currentState!.toImage();
final witnessImage = await _witnessKey.currentState!.toImage();
// Submit both signatures
}
}
Pattern 3: Read-only Signature Display
class SignatureDisplay extends StatefulWidget {
final Uint8List signatureData;
SignatureDisplay({required this.signatureData});
@override
_SignatureDisplayState createState() => _SignatureDisplayState();
}
class _SignatureDisplayState extends State<SignatureDisplay> {
@override
Widget build(BuildContext context) {
return Container(
height: 200,
decoration: BoxDecoration(
border: Border.all(color: Colors.grey),
borderRadius: BorderRadius.circular(8),
),
child: Image.memory(
widget.signatureData,
fit: BoxFit.contain,
),
);
}
}
Pattern 4: Signature with Real-time Feedback
class InteractiveSignaturePad extends StatefulWidget {
@override
_InteractiveSignaturePadState createState() => _InteractiveSignaturePadState();
}
class _InteractiveSignaturePadState extends State<InteractiveSignaturePad> {
final GlobalKey<SfSignaturePadState> _signaturePadKey = GlobalKey();
bool _isDrawing = false;
int _strokeCount = 0;
@override
Widget build(BuildContext context) {
return Column(
children: [
Container(
height: 300,
decoration: BoxDecoration(
border: Border.all(
color: _isDrawing ? Colors.blue : Colors.grey,
width: _isDrawing ? 2 : 1,
),
borderRadius: BorderRadius.circular(8),
),
child: SfSignaturePad(
key: _signaturePadKey,
backgroundColor: Colors.white,
strokeColor: Colors.black,
minimumStrokeWidth: 2.0,
maximumStrokeWidth: 4.0,
onDrawStart: () {
setState(() {
_isDrawing = true;
_strokeCount++;
});
return true;
},
onDrawEnd: () {
setState(() {
_isDrawing = false;
});
},
),
),
SizedBox(height: 8),
Text(
_isDrawing ? 'Drawing...' : 'Stroke count: $_strokeCount',
style: TextStyle(color: Colors.grey[600]),
),
],
);
}
}
Key Properties
Essential Properties
backgroundColor- Background color of the signature pad (Color)strokeColor- Color of the signature strokes (Color, default: Colors.black)minimumStrokeWidth- Minimum width of strokes (double, default: 1.0)maximumStrokeWidth- Maximum width of strokes (double, default: 4.0)
Callback Properties
onDrawStart- Callback when drawing starts (SignatureOnDrawStartCallback → bool Function(); return true to allow drawing, false to cancel)onDraw- Callback during drawing with offset and timestamp (DrawCallback)onDrawEnd- Callback when drawing ends (VoidCallback)
State Methods (via GlobalKey)
clear()- Clears all strokes from the signature padtoImage({double pixelRatio})- Converts signature to ui.ImagepixelRatio- Resolution multiplier (default: 1.0, higher = better quality)
Common Use Cases
- Contract Signing - Digital signature capture for legal documents and agreements
- Delivery Confirmation - Capture recipient signatures for package deliveries
- Medical Consent Forms - Patient signatures for consent and authorization
- Registration Forms - User signatures during account creation or registration
- Checkout Process - Signature capture during payment or purchase completion
- Approval Workflows - Manager or authority signatures for approvals
- Receipt Acknowledgment - Customer signatures on digital receipts
- Time Sheet Signing - Employee signatures for attendance or timesheet approval
- Visitor Management - Visitor signatures during check-in processes
- Terms Acceptance - Signature-based acceptance of terms and conditions
Best Practices
Validation
// Always validate before saving
Future<bool> validateSignature() async {
try {
final image = await _signaturePadKey.currentState!.toImage();
// Check if image has meaningful content
return true;
} catch (e) {
return false; // No signature drawn
}
}
Image Quality
// Use higher pixel ratio for better quality
final image = await _signaturePadKey.currentState!.toImage(
pixelRatio: 3.0, // 3x resolution for high-quality signatures
);
User Experience
- Provide clear "Clear" and "Save" buttons
- Show visual feedback during drawing (border highlight)
- Display validation messages clearly
- Consider adding "Sign Here" indicator or background watermark
- Allow users to retry if they make mistakes
- Show confirmation after successful signature capture
Storage
import 'dart:ui' as ui;
import 'dart:typed_data';
Future<Uint8List> getSignatureBytes() async {
final ui.Image image = await _signaturePadKey.currentState!.toImage(
pixelRatio: 3.0,
);
final ByteData? byteData = await image.toByteData(
format: ui.ImageByteFormat.png,
);
return byteData!.buffer.asUint8List();
}
Tips and Gotchas
- Always use a
GlobalKey<SfSignaturePadState>to access signature pad methods - Call
toImage()before navigating away to preserve the signature - Higher
pixelRatiovalues produce larger files but better quality - Clear the pad when validation fails to avoid confusion
- Test on both touch devices and stylus-enabled devices
- Consider adding a stroke count check for validation
- Use contrasting colors for stroke and background for visibility
- Provide adequate height (150-300px) for comfortable signing
FAQ
What does the syncfusion-flutter-signature-pad skill do?
Implements Syncfusion Flutter SignaturePad (SfSignaturePad) for capturing handwritten signatures and drawings in Flutter apps. Use when implementing digital signatures, document signing, e-signature fields, or touch/stylus drawing surfaces. This skill covers stroke customization, background color, saving signatures as images, and clearing the pad.
How do I install syncfusion-flutter-signature-pad?
Run npx skills add https://github.com/syncfusion/flutter-ui-components-skills --skill syncfusion-flutter-signature-pad in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/syncfusion-flutter-signature-pad/ (personal) or .claude/skills/syncfusion-flutter-signature-pad/ (project).
Which AI agents can use syncfusion-flutter-signature-pad?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is syncfusion-flutter-signature-pad safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains syncfusion-flutter-signature-pad?
It is published by syncfusion in syncfusion/flutter-ui-components-skills. It has 49 recorded installs.
More from syncfusion/flutter-ui-components-skills
syncfusion-flutter-calendar-datepicker
syncfusion/flutter-ui-components-skills
Open the skill to read its SKILL.md instructions.
syncfusion-flutter-cartesian-charts
syncfusion/flutter-ui-components-skills
Implements Syncfusion Flutter Cartesian Charts (SfCartesianChart) for a wide range of 2D chart types in Flutter apps. Use when working with line, column, bar, area, spline, scatter, bubble, financial, stacked, or histogram charts. This skill covers axis types (NumericAxis, CategoryAxis, DateTimeAxis), zoom and pan, tooltip, trackball, legend, annotations, technical indicators, trendlines, and chart export.
syncfusion-flutter-datagrid
syncfusion/flutter-ui-components-skills
Implements Syncfusion Flutter DataGrid (SfDataGrid) for displaying and manipulating tabular data in Flutter applications. Use when working with data grids, data tables, or column-based data presentation using the syncfusionflutterdatagrid package. This skill covers DataGridSource, GridColumn configuration, sorting, filtering, paging, editing, and selection.
syncfusion-flutter-chat
syncfusion/flutter-ui-components-skills
Implements Syncfusion Flutter Chat (SfChat) and AI AssistView (SfAIAssistView) widgets for conversational interfaces in Flutter apps. Use when building chat UIs, AI chatbot interfaces, or messaging screens with support for message bubbles, composers, and action buttons. This skill covers conversation area customization, placeholder screens, theming, RTL support, and AI assistant integration.
syncfusion-flutter-circular-charts
syncfusion/flutter-ui-components-skills
Open the skill to read its SKILL.md instructions.
syncfusion-flutter-sliders
syncfusion/flutter-ui-components-skills
Implements Syncfusion Flutter Slider controls (SfSlider, SfRangeSlider, SfRangeSelector) for numeric value selection and range inputs. Use when working with single-value sliders, range selection, or chart-range controllers in Flutter apps. This skill covers thumb and tooltip customization, ticks, dividers, RTL support, drag modes, and chart integrations.
Popular mobile skills
design-mobile-apps
designed-by-ai/skills
Design mobile app screens with Sleek, edit Sleek projects, and implement their designs in React Native or HTML.
ios-design
uizze.sh
Design and review iOS UI/UX for iPhone apps in SwiftUI, UIKit, or React Native. Use for mobile app design, screen redesigns, navigation flows, typography, forms, keyboard and safe-area layout, and accessibility checks. Apply Apple Human Interface Guidelines and consult real product references through the optional Uizze connection.
vercel-react-native-skills
vercel-labs/agent-skills
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
animate-expo
emilkowalski/skills
Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use animate.
xcode-project-setup
firebase/agent-skills
Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).
firebase-remote-config-basics
firebase/agent-skills
Manages Firebase Remote Config templates, feature flags, loading strategies, and SDKs (Android, iOS). Use when downloading/deploying remoteconfig JSON templates, managing version history/feature flags, setting in-app defaults, fetchAndActivate(), real-time listeners, or SDK setup. Don't use for Firebase Hosting, Auth, Firestore, Data Connect, Crashlytics, or App Hosting.