Weave Code
Laravel Sign Pad Laravel Package
creagia/laravel-sign-pad
A Laravel package for signing documents and optionally generating certified PDFs tied to Eloquent models. Add the RequiresSignature trait, publish assets, and configure storage and redirects. Supports Laravel 11-13 on PHP 8.2-8.5.
creagia/laravel-sign-pad is a Laravel package that lets you capture signatures for Eloquent models and optionally generate certified PDFs tied to those models. Install it via Composer, run php artisan sign-pad:install, publish the JS assets, then add the RequiresSignature trait to any model implementing CanBeSigned.
- Draw signatures in the browser using bundled JS assets copied to
public/vendor/sign-pad - Store signatures and signed documents on configurable disks and routes
- Optionally generate certified PDFs using custom document templates
- Configure a post-signing redirect route, which receives the signature
$uuid - Requires PHP 8.2–8.5 and Laravel 11–13
Frequently asked questions about Laravel Sign Pad
- How do I install creagia/laravel-sign-pad in a Laravel application?
- Install it with Composer using composer require creagia/laravel-sign-pad. Then run php artisan sign-pad:install to publish the config and migration files. Publish the frontend assets with php artisan vendor:publish --tag=sign-pad-assets, then run php artisan migrate. The assets are copied to public/vendor/sign-pad/.
- What Laravel and PHP versions does laravel-sign-pad support?
- The package requires PHP 8.2 through 8.5 and Laravel 11 through 13. Check these versions before installing because the package has a hard dependency on that range. If your app is on an older Laravel or PHP release, you will need to upgrade or choose a different package.
- How do I add signature capture to an Eloquent model with laravel-sign-pad?
- Add the RequiresSignature trait and implement the CanBeSigned contract on the model you want to sign. If you also need generated documents, implement ShouldGenerateSignatureDocument and define getSignatureDocumentTemplate with the required SignaturePosition values. Then include the x-creagia-signature-pad Blade component in your form and post to the model's signature route.
- How does laravel-sign-pad generate certified PDFs?
- Implement ShouldGenerateSignatureDocument on the model and define a document template in getSignatureDocumentTemplate. The package uses TCPDF to generate the PDF and can produce a digitally certified PDF when OpenSSL certificates are configured. This is optional, so you can use the package only for signature capture if certified PDFs are not required.
- Where are signatures and signed PDF documents stored with laravel-sign-pad?
- Storage is configured in config/sign-pad.php, where you can choose the disk and paths for signatures and documents. Any Laravel-supported disk can be used, including local storage or S3. You can also configure the redirect_route_name that receives the signature UUID after signing.
- Can I customize the laravel-sign-pad Blade signature pad component?
- Yes, the package provides a Blade component, x-creagia-signature-pad, with configurable props such as pad-classes, button-classes, border-color, and disabled-without-signature. You can adjust these props to match your UI and existing CSS approach. The published JavaScript assets live under public/vendor/sign-pad/, so review how they fit your asset pipeline.
- How do I test signature capture and PDF generation in a Laravel app using laravel-sign-pad?
- Use Laravel's HTTP testing and Storage fakes to assert that signing requests create the expected signature records and files. For PDF generation, test the model contract methods and template configuration, then assert the generated document behavior in an isolated test. The package itself has a GitHub Actions test workflow, but you should still cover your own routes, storage disks, and certificate setup.
- What production concerns should I check before using laravel-sign-pad with TCPDF certified PDFs?
- Certified PDFs require OpenSSL certificate setup, so plan for certificate storage, renewal, and access control. Misconfigured TCPDF certification can invalidate signatures, so validate output with your legal and compliance requirements. Also benchmark PDF generation for high-volume signing and decide whether a certification failure should reject signing or fall back to a non-certified PDF.
- Does laravel-sign-pad support multiple signatures on a single PDF document?
- Yes, the SignaturePosition class is designed to place multiple signatures within a document template. You still need to test edge cases such as partial signatures and page breaks for your specific template. Define the positions in getSignatureDocumentTemplate and verify the final PDF layout.
- What are alternatives to creagia/laravel-sign-pad for e-signatures in Laravel?
- Alternatives depend on whether you need simple handwritten signature capture, PDF generation, or legally certified e-signatures. If you only need a signature pad, a lightweight JavaScript signature library plus Laravel storage may be enough. For certified or regulated workflows, compare dedicated e-signature services and validate TCPDF-based certification against your compliance needs.
Weaver
How can I help you explore Laravel packages today?