barcode-tools/README.md

Barcode Tools

Generate and decode QR codes and barcodes locally in the browser.

Barcode Tools is a standalone local-first application in the add·ideas Toolbox. Inputs are processed in the browser and are not uploaded.

Version 0.1 scope

• Local SVG generation for QR, Data Matrix, PDF417, Aztec and selected linear symbologies
• Local barcode decoding from a bounded image file or an explicitly enabled camera
• Escaped URL, email, SMS, Wi-Fi, vCard and geo QR payload builders
• Bounded CSV batch generation into a deterministic SVG ZIP
• GTIN check-digit validation plus non-authoritative quiet-zone guidance

Generated SVG is checked for active or linked content before preview/download. Decoded payloads are displayed as text and never opened automatically. Scanner interoperability, GS1 allocation and print quality still require testing against the applicable specifications. See docs/ARCHITECTURE.md and docs/PRIVACY-SECURITY.md.

Development

Requires Node.js 22 and npm 11.

npm ci
npm run check
npm run test:browser

Release

npm run release:artifact creates a deterministic release/barcode-tools-0.1.0.zip and checksum sidecar.

Licence

GPL-3.0-or-later. Runtime dependencies retain their own licences; see THIRD_PARTY_NOTICES.md.