PHPackages nowo-tech/pdf-signable-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [PDF & Document Generation](/categories/documents) 4. / 5. nowo-tech/pdf-signable-bundle ActiveSymfony-bundle[PDF & Document Generation](/categories/documents) nowo-tech/pdf-signable-bundle ============================= Define signature box coordinates on PDFs in Symfony: form type with PDF.js viewer, drag-and-drop placement, validation, and signing hooks. v3.0.8(2w ago)02.0k↓34.6%MITPHPPHP >=8.2 <8.6CI passing Since Feb 9Pushed 2w agoCompare [ Source](https://github.com/nowo-tech/PdfSignableBundle)[ Packagist](https://packagist.org/packages/nowo-tech/pdf-signable-bundle)[ Docs](https://github.com/nowo-tech/PdfSignableBundle)[ GitHub Sponsors](https://github.com/HecFranco)[ RSS](/packages/nowo-tech-pdf-signable-bundle/feed)WikiDiscussions master Synced 2w ago READMEChangelog (10)Dependencies (52)Versions (42)Used By (0) PdfSignable Bundle ================== [](#pdfsignable-bundle) [![CI](https://github.com/nowo-tech/PdfSignableBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/PdfSignableBundle/actions/workflows/ci.yml) [![Packagist Version](https://camo.githubusercontent.com/d53327fca8ff402c838ee315044d47b29086805592fe9a23d5a2dd0c5a8a7af6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f7064662d7369676e61626c652d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/pdf-signable-bundle) [![Packagist Downloads](https://camo.githubusercontent.com/ed2a6fdc1b9e9e21d308ca4d50e03e12c4ea7b85d60e8e1c94310f062b03674f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f7064662d7369676e61626c652d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/pdf-signable-bundle) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/7d4e4aaeb2d34975bb7d4d31bd666f354efd01e011d1799c80335c7a7cd62e7a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e30253242253230253743253230382e302532422d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) > ⭐ **Found this useful?** [Install from Packagist](https://packagist.org/packages/nowo-tech/pdf-signable-bundle) · Give it a star on [GitHub](https://github.com/nowo-tech/PdfSignableBundle) to help others find it. [![FrankenPHP Friendly Worker Mode](docs/images/frankenphp-friendly.png)](docs/images/frankenphp-friendly.png) This bundle is **FrankenPHP worker mode friendly**. **FrankenPHP worker mode:** Supported — PDF proxy and AcroForm Process calls use configured HTTP/process timeouts; demos ship FrankenPHP with `FRANKENPHP_MODE` (see [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md)). Table of contents ----------------- [](#table-of-contents) - [What is this?](#what-is-this) - [Features](#features) - [Installation](#installation) - [Configuration](#configuration) - [Usage](#usage) - [Documentation](#documentation) - [Tests and coverage](#tests-and-coverage) - [License](#license) **Symfony bundle to define signature box coordinates on PDFs.** Form type with an in-browser PDF.js viewer: users place and resize signature areas by clicking and dragging. Supports units (mm, cm, pt), validation, proxy for external PDFs, and hooks for PKI/timestamp/batch signing. Symfony 7.x, 8.x · PHP 8.2+. What is this? ------------- [](#what-is-this) This bundle helps you **define signature box coordinates on PDFs** in your Symfony applications for: - 📄 **PDF signature placement** — Let users visually place and resize signature areas on a PDF - 📐 **Units and origin** — Work in mm, cm, pt, px or in; choose coordinate origin (e.g. bottom-left) - 🔗 **External PDFs** — Optional proxy to load external PDFs without CORS issues - ⚙️ **Named profiles** — Reuse presets (fixed URL, units, limits) via `config: 'name'` in YAML - ✅ **Validation** — Required box names, unique names per form, min/max entries - 🎯 **Events** — Hook into proxy request/response and coordinate submission for custom logic Quick Search Terms ------------------ [](#quick-search-terms) Looking for: **PDF signature coordinates**, **signature box placement**, **PDF.js Symfony**, **PDF form coordinates**, **signature position configurator**, **Symfony PDF viewer**, **signature overlay**, **PDF signing workflow**, **coordinate picker**, **document signing**? You've found the right bundle! Features -------- [](#features) - ✅ **Form type** — `SignatureCoordinatesType` with PDF URL, units (mm, cm, pt, px, in), coordinate origin (corners) and collection of signature boxes - ✅ **PDF viewer** — In-browser viewer (PDF.js) with overlays for each box; click to add, drag to move, drag corners to resize - ✅ **Optional proxy** — Load external PDFs without CORS; configurable via `nowo_pdf_signable.proxy_enabled` - ✅ **Named configurations** — Define presets in `nowo_pdf_signable.signature.profiles` (or `acroform.profiles`) and use `config: 'alias'` when adding the form type - ✅ **URL modes** — Free-text URL input or dropdown choice (`url_mode: choice`, `url_choices`) - ✅ **Box options** — Name as text or dropdown (`name_mode: choice`); min/max entries; optional **unique box names** validation; **page restriction** (`allowed_pages`); **sort order** on submit (`sort_boxes`); **no overlapping boxes** (`prevent_box_overlap`, default true); **minimum box size** (`min_box_width`, `min_box_height`); **optional rotation** (`enable_rotation`); **default values per name** (`box_defaults_by_name`); **snap to grid** (`snap_to_grid`) and **snap to other boxes** (`snap_to_boxes`, default true); **guides and grid** (`show_grid`, `grid_step`); **viewer lazy load** (`viewer_lazy_load`); **batch signing** (`batch_sign_enabled`, “Sign all” button). **Audit**: optional fill from request (`audit.fill_from_request`), placeholders for TSA and signing service (see [SIGNING\_ADVANCED](docs/SIGNING_ADVANCED.md)) - ✅ **Viewer** — **Thumbnails**: page strip to jump to a page; **Zoom**: toolbar (zoom in, zoom out, fit width, translated); **Touch**: pinch to zoom, two-finger pan on tablets - ✅ **Validation** — Required box name (NotBlank); `unique_box_names` global (`true`/`false`) or per-name (array) to enforce unique box names - ✅ **Events** — `PdfProxyRequestEvent`, `PdfProxyResponseEvent`, `SignatureCoordinatesSubmittedEvent`, `BatchSignRequestedEvent`, `PdfSignRequestEvent` for integration (see [EVENTS](docs/EVENTS.md) and [SIGNING\_ADVANCED](docs/SIGNING_ADVANCED.md)) - ✅ **Compatibility** — Symfony 7.x, 8.x and PHP 8.2+ Screenshots ----------- [](#screenshots) **Demo index** — Each card shows a different way to configure `SignatureCoordinatesType` (named profiles, URL options, box validation, model prefill): [![Demo home — configuration overview](docs/img/demo-home.png)](docs/img/demo-home.png) **Signature coordinates form** — PDF viewer with draggable signature boxes; unit/origin selector and box list on the right: [![Signature coordinates form — PDF viewer and boxes](docs/img/demo-signature-form.png)](docs/img/demo-signature-form.png) **Signature form (alternate view)** — Same form with thumbnails strip, zoom toolbar and optional rotation; boxes can be placed flush to page edges at any angle: [![Signature form — thumbnails, zoom and rotation](docs/img/demo-signature-form-2.png)](docs/img/demo-signature-form-2.png) Installation ------------ [](#installation) ``` composer require nowo-tech/pdf-signable-bundle ``` [Symfony Flex](https://symfony.com/doc/current/setup/flex.html) registers the bundle automatically. Otherwise see [Installation](docs/INSTALLATION.md) to register the bundle and routes. **Unreleased / dev:** To use the latest default branch (`main` or `master`), add the VCS repo and require `dev-main` or `dev-master` — see [docs/INSTALLATION.md](docs/INSTALLATION.md). Quick Start ----------- [](#quick-start) 1. **Add the form type** to your form (or use the default route `/pdf-signable`): ``` use Nowo\PdfSignableBundle\Form\SignatureCoordinatesType; use Nowo\PdfSignableBundle\Model\SignatureCoordinatesModel; $model = new SignatureCoordinatesModel(); $form = $this->createForm(SignatureCoordinatesType::class, $model); // Or use a named config: ['config' => 'fixed_url'] ``` 2. **Render the form** with the bundle form theme so the PDF viewer and boxes render correctly: ``` {% form_theme form '@NowoPdfSignableBundle/form/theme.html.twig' %} {{ form_widget(form.signatureCoordinates) }} ``` 3. **On submit** you get a `SignatureCoordinatesModel` with `pdfUrl`, `unit`, `origin` and `signatureBoxes` (each with name, page, x, y, width, height, and angle when `enable_rotation` is true). Configure `nowo_pdf_signable` (proxy, example URL, optional [named profiles](docs/CONFIGURATION.md)) as needed. See [Usage](docs/USAGE.md) for full options and examples. Requirements ------------ [](#requirements) - PHP >= 8.2 (Symfony **8.0** requires PHP **8.4+**; Symfony **8.1+** requires PHP **8.4.1+**) - **Symfony >= 7.0** || >= 8.0 - PHP extensions required by Symfony (e.g. json, mbstring, ctype, xml, fileinfo). **Optional:** `ext-yaml` for faster YAML config parsing (see `composer suggest`) Configuration ------------- [](#configuration) The bundle works with default settings. Create or edit `config/packages/nowo_pdf_signable.yaml`: ``` nowo_pdf_signable: proxy_enabled: true # Proxy route for external PDFs (avoids CORS) # example_pdf_url: bundle default is a sample public PDF URL; set to '' to disable preload # debug: false # Browser console logging for the viewer (default false) signature: profiles: {} # Named presets; see CONFIGURATION.md ``` See [CONFIGURATION.md](docs/CONFIGURATION.md) for the full tree (`proxy_url_allowlist`, `audit`, `tsa_url`, `signing_service_id`, `acroform.*`, etc.) and default values. Demos ----- [](#demos) Dockerized demos (Symfony 7 and 8, Bootstrap, Vite, TypeScript) with multiple usage examples. They run with **FrankenPHP** (Caddy + PHP): the **Dockerfile** ships a production Caddyfile with **`php_server` worker**, but with **`APP_ENV=dev`** the container **entrypoint swaps in `Caddyfile.dev`** (no worker, cache-busting headers) so local dev matches [docs/DEMO-FRANKENPHP.md](docs/DEMO-FRANKENPHP.md). Served over **HTTPS** on localhost (self-signed certificate; accept it in the browser). The [screenshots above](#screenshots) show the demo home (configuration cards), the signature coordinates form (PDF viewer + boxes), and an alternate view with thumbnails, zoom and rotation. ``` cd demo make run-symfony7 # → https://localhost:8001 make run-symfony8 # → https://localhost:8002 ``` Twenty-plus demos: no config, default config, fixed\_url, overridden config, URL as dropdown, limited boxes, same signer (multiple locations), unique per name (array), page restriction, sorted boxes, no-overlap, allow-overlap, **min-size-boxes**, rotation, defaults-by-name, snap-to-grid, **guides-and-grid**, **viewer lazy-load**, **AcroForm editor**, **AcroForm editor min-size**, latest features (combined), predefined boxes; plus signing (draw, upload, legal disclaimer, predefined boxes — sign only, signing options). See [demo/README.md](demo/README.md) and [demo/Makefile](demo/Makefile). ### Xdebug [](#xdebug) Demos include **Xdebug**. Your IDE should listen on port **9003**. To start only on demand, set `XDEBUG_START_WITH_REQUEST=trigger` in the demo `docker-compose.yml` and use your IDE trigger. Frontend (Vite + TypeScript) ---------------------------- [](#frontend-vite--typescript) The PDF viewer is built with **Vite** and **TypeScript**. The bundle ships a built file at `src/Resources/public/js/pdf-signable.js`. After installing the bundle: ``` php bin/console assets:install ``` To rebuild from source (bundle root): ``` pnpm install pnpm run build ``` Tests and QA ------------ [](#tests-and-qa) From the bundle root (optionally via Docker): ``` make up make install make test # PHPUnit make test-coverage # PHPUnit + HTML (coverage/) and Clover (coverage.xml). Requires PCOV in the container. make cs-check # PHP-CS-Fixer make qa # cs-check + test make validate-translations # Validate translation YAML files (inside Docker) ``` Or locally: `composer test`, `composer test-coverage`, `composer cs-check`, `composer qa`. The bundle Docker image includes PCOV for coverage. Documentation ------------- [](#documentation) - [GitHub Actions CI requirements](docs/GITHUB_CI.md) - [Installation](docs/INSTALLATION.md) - [Configuration](docs/CONFIGURATION.md) - [Usage](docs/USAGE.md) - [Contributing](docs/CONTRIBUTING.md) - [Code of Conduct](CODE_OF_CONDUCT.md) - [Changelog](docs/CHANGELOG.md) - [Upgrading](docs/UPGRADING.md) - [Release](docs/RELEASE.md) - [Security](docs/SECURITY.md) - [Engram](docs/ENGRAM.md) - [Spec-driven development](docs/SPEC-DRIVEN-DEVELOPMENT.md) - [GitHub Spec Kit](docs/SPEC-KIT.md) - [Roadmap](docs/ROADMAP.md) ### Additional documentation [](#additional-documentation) - [Demo with FrankenPHP (development and production)](docs/DEMO-FRANKENPHP.md) - [Workflow](docs/WORKFLOW.md) - [AcroForm backend](docs/ACROFORM_BACKEND_EXTENSION.md) - [Events](docs/EVENTS.md) - [Advanced signing](docs/SIGNING_ADVANCED.md) - [Styles](docs/STYLES.md) - [Testing](docs/TESTING.md) - [Accessibility](docs/ACCESSIBILITY.md) Tests and coverage ------------------ [](#tests-and-coverage) - Tests: PHPUnit (PHP), pytest (Python scripts) - PHP: 99.18% - TS/JS: 81.28% - Python: 21% License ------- [](#license) The MIT License (MIT). Please see [LICENSE](LICENSE) for more information. Contributing ------------ [](#contributing) We welcome contributions! Please see [CONTRIBUTING.md](docs/CONTRIBUTING.md) for details on how to contribute to this project. For security issues see [SECURITY.md](docs/SECURITY.md). Author ------ [](#author) Created by [Héctor Franco Aceituno](https://github.com/HecFranco) at [Nowo.tech](https://nowo.tech) ### Health Score 51 — FairBetter than 95% of packages Maintenance96 Actively maintained with recent releases Popularity21 Limited adoption so far Community9 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 78.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~6 days Total 27 Last Release 18d ago Major Versions v1.5.3 → v2.0.02026-02-16 v2.0.7 → v3.0.02026-07-02 PHP version history (3 changes)1.0.0PHP >=8.1 v2.0.5PHP >=8.1 <8.6 v3.0.0PHP >=8.2 <8.6 ### Community Maintainers ![](https://www.gravatar.com/avatar/e7947bfc3f2ce9574a18a2c60f3d95b5d1b0740e65dc929332c92f1df21f75ab?d=identicon)[HecFranco](/maintainers/HecFranco) --- Top Contributors [![HecFranco](https://avatars.githubusercontent.com/u/24323276?v=4)](https://github.com/HecFranco "HecFranco (93 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (14 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (11 commits)") --- Tags frankenphppdfphpsymfonysymfony-bundlesymfonypdfsignaturesigningformpdfjsSymfony BundlecoordinatesForm Typeeidaspdf viewerdocument-signingsignature-coordinates ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Rector Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/nowo-tech-pdf-signable-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/nowo-tech-pdf-signable-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-pdf-signable-bundle) ``` ### Alternatives [kimai/kimai Kimai - Time Tracking 4.8k9.4k1](/packages/kimai-kimai)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.5k6.0M777](/packages/sylius-sylius)[chameleon-system/chameleon-base The Chameleon System core. 1029.4k6](/packages/chameleon-system-chameleon-base)[contao/core-bundle Contao Open Source CMS 1301.7M3.1k](/packages/contao-core-bundle)[easycorp/easyadmin-bundle Admin generator for Symfony applications 4.3k18.3M429](/packages/easycorp-easyadmin-bundle)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.8M672](/packages/shopware-core) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)