label-tools/public/README.md

Label Tools

Label Tools combines bounded CSV/JSON data merge with calibrated label stocks and a reusable visual template designer. Text, image, barcode and shape elements can be positioned by drag, keyboard or exact mm/in/pt fields; template JSON round-trips locally. Bleed, sheet bounds, barcode quiet zones and likely scan-size problems are checked before print. Physical-size SVG and vector PDF exports retain paths and text, while local raster images remain embedded image objects.

Label Tools is a production-oriented, local-first browser studio for merging CSV/JSON records into printable label, badge and asset-tag sheets.

Version 0.2.0 includes:

• bounded CSV and JSON parsing with nested JSON field flattening;
• explicit field mapping plus local serial and cryptographically random values;
• address-label, name-badge and asset-tag layouts with automatic text fitting;
• locally embedded PNG, JPEG and WebP assets selected by filename or default;
• QR Code, Code 128, GS1-128, EAN-13, EAN-8, UPC-A, Code 39, Data Matrix, PDF417 and Aztec Code fields through the bundled bwip-js encoder;
• millimetre, inch and point input with common A4/US Letter stocks and a validated custom grid;
• start-slot selection, X/Y offset and independent scale calibration;
• optional cut guides and registration marks;
• paginated print preview and explicit print calibration guidance;
• vector SVG, deterministic multi-page SVG/report ZIP, and vector PDF export.

Data and assets remain in browser memory. There is no telemetry, remote API, font download, CDN asset or automatic request.

Run and verify

npm ci
npm run dev
npm run check
npm run test:browser
npm run package:release -- --force

Node.js 22 or newer and the Chromium/Firefox Playwright browsers are required for the complete verification suite.

Print and font boundary

Label-stock names describe common geometries, not vendor certification. Measure the actual sheet, print the registration/cut marks on plain paper, choose “actual size” or 100% scale, and disable browser headers/footers before using stock. Printer feed and unprintable margins are outside browser control.

SVG uses one of four system font stacks and does not embed fonts. Results can therefore vary by operating system. PDF export maps application-owned SVG geometry into pdf-lib vector paths, rectangles and embedded Helvetica text. Characters outside the built-in WinAnsi repertoire are replaced visibly, and unsupported WebP image objects remain available in SVG but are omitted from PDF. The result is print-accurate in physical dimensions, not an archival PDF.

Limits

Merge data is limited to 2 MiB, 2,000 rows, 100 fields and 10,000 characters per field. Up to 50 local raster images / 32 MiB total are accepted, with 8 MiB and 40 megapixels per image. Print/PDF runs are capped at 100 pages; SVG ZIP remains available for larger bounded merges.

Licence

Copyright © 2026 Albrecht Degering. Label Tools is free software licensed under the GNU General Public License v3.0 or later. See LICENSE.