Initial release of Barcode Tools 0.1.0

2026-09-01 02:55:06 +02:00
commit 81677e1134
58 changed files with 9200 additions and 0 deletions
@@ -0,0 +1,33 @@
+# 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](https://git.add-ideas.de/lotobo/toolbox-portal). 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](docs/ARCHITECTURE.md) and [docs/PRIVACY-SECURITY.md](docs/PRIVACY-SECURITY.md).
+
+## Development
+
+Requires Node.js 22 and npm 11.
+
+```sh
+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](THIRD_PARTY_NOTICES.md).