Batch Document Studio
Add placement guides, keyboard/numeric positioning, duplicate fields and a cancellable selected-record ZIP queue.
The problem it solves
Batch Document Studio Batch Document Studio turns a PDF or image template and a CSV/XLSX spreadsheet into a ZIP of personalized PDF or PNG documents. It runs entirely in the browser: templates, recipient rows, rendered documents, and ZIP contents stay on the device.
Who Batch Document Studio is for
- People who need a small, purpose-built utility instead of a broad platform.
- Users working with document generation, spreadsheets, PDF who want the documented v1.2.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Add placement guides, keyboard/numeric positioning, duplicate fields and a cancellable selected-record ZIP queue.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.2.0
Capabilities below come from the current project README and release documentation.
Reads CSV and explicitly selected XLSX worksheets.
Preserves duplicate or blank spreadsheet headers by assigning stable unique names.
Previews each page of PDF templates and full PNG/JPEG templates.
Maps any spreadsheet column to draggable text fields with size, color, alignment, and width controls.
Places fields independently across every page of a PDF template.
Wraps multiline text, shrinks long text to a chosen minimum size, or flags possible clipping.
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Verified release evidence
This project does not currently publish a screenshot or dedicated example folder. The current README, tests, changelog, tagged release, and source repository remain the verified examples of its behavior.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Browser
- Windows
- macOS
- Linux
Built with
- TypeScript
- Vite
- PDF.js
- pdf-lib
What changed in v1.2.0
Add placement guides, keyboard/numeric positioning, duplicate fields and a cancellable selected-record ZIP queue.
The preview toolbar wraps at 390 pixels. Fields support numeric percentages, arrow-key nudging (0.1%, Shift 1%), page-aware edge/center guides and duplication. XLSX worksheet selection and explicit record ranges control exports, with original worksheet row numbers retained in manifests and preflight. ZIP parts render sequentially, await an explicit download before continuing, and cap buffered document bytes at 32 MB per part with 1–50 records per part. Cancellation discards the current undownloaded part and stops subsequent work; previously downloaded parts remain. Inputs, parser memory, a single document render and compression overhead are outside that output-buffer cap. Large parts fail with guidance to select fewer records. Collision-safe names span the queue. Templates, rows and fonts stay local; a blank sample template supports an entirely local walkthrough. Automated PDF/ZIP tests verify numbering, cancellation and limits; desktop/mobile browser QA exercised numeric placement, duplication and queue cancellation. File-scheme launch, physical print accuracy and every XLSX producer are not claimed.
Validation: npm run check, npm audit, and npm run package.
Quick start
The shortest documented path into the current release.
- Open the browser application or serve the downloaded release ZIP with a local static server.
- Choose a multi-page PDF, PNG, or JPEG template up to 25 MB.
- Choose a CSV or XLSX spreadsheet. Select the XLSX worksheet. The first row supplies field names.
- Add fields, select their spreadsheet columns, choose wrapping or shrink-to-fit, and drag them
onto any template page.
- Preview multiple records, choose PDF or PNG, set a filename pattern, and select records and Build ZIP queue.
The ZIP contains one file per non-empty spreadsheet row plus a JSON manifest connecting each filename to its original spreadsheet row number.
Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
- Custom fonts are user-supplied and are not stored in recipes; reattach the font each session and
confirm its license permits embedding. Complex-script shaping still depends on the selected font and PDF library capabilities.
- PNG output represents the first template page only. Fields mapped to later pages are reported by
preflight and omitted from PNG output.
- PNG output uses the rendered preview resolution. It is not a print-preflight or color-management system.
- The tool does not email recipients, host QR verification records, sign documents, or persist
projects automatically. Portable recipes are explicit downloads and exclude templates and rows.
.xls, password-protected spreadsheets, macros, Google Sheets URLs, and multi-sheet selection are not supported.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
The production bundle makes no application network requests. All parsing and rendering happens in the browser. The public demo requires a normal page request to GitHub Pages, but uploaded files are not transmitted by the application.
Treat recipient spreadsheets and output ZIPs as sensitive. Batch Document Studio does not encrypt them, delete copies from your downloads folder, verify that you have permission to use a template, or certify that generated documents are legally valid credentials.
Untrusted PDF, image, and spreadsheet files are processed by third-party parsers inside the browser. Keep the browser current and use the documented 25 MB template limit. See [SECURITY.md](SECURITY.md) for private vulnerability reporting.
License and release
Batch Document Studio is published under MIT. The current cataloged release is v1.2.0, published 2026-09-07.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Batch Document Studio v1.2.0
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical local repository. Fingerprint: a7cef919ad526fd3.