Barcode Input Bundle

Star Found this useful? Install it from Packagist and support the project on GitHub.

Symfony FormType for barcode capture with optional camera scanning (ZXing) and hardware wedge scanner support.

This bundle is FrankenPHP worker mode friendly.

Table of contents

• Features
• Quick usage
• Demo preview
• Documentation
• Tests and coverage
• License

Features

• BarcodeType::class for product codes, warehouse labels, inventory scans.
• Optional camera scanner button powered by @zxing/browser.
• Compatible with USB/Bluetooth keyboard-wedge barcode scanners.
• Normalizes whitespace and non-printable characters server-side.
• TypeScript + Vite assets in src/Resources/assets (named package nowo_barcode_input).
• Translations de, en, es, fr, it, nl, pt.
• Multi-framework Twig themes (Bootstrap, Tailwind, Foundation, Symfony default).

Quick usage

use Nowo\BarcodeInputBundle\Form\BarcodeType;

$builder->add('barcode', BarcodeType::class, [
    'enable_scanner' => true,
    'max_length' => 13,
    'formats' => ['ean_13', 'ean_8', 'upc_a'],
    'container_class' => 'nowo-barcode-input__container',
    'input_class' => 'form-control',
    'button_class' => 'btn btn-outline-secondary',
]);

The value received in barcode is a single normalized string, for example 40170725.

Demo preview

Documentation

• GitHub Actions CI requirements
• Installation
• Configuration
• PSR evaluation (REQ-CS-007)
• Usage
• Contributing
• Code of Conduct
• Changelog
• Upgrading
• Release
• Security
• Engram
• Spec-driven development
• GitHub Spec Kit

Additional documentation

• Demo notes

Tests and coverage

• PHP: 100%
• TS/JS: 100%
• Python: N/A

License

This bundle is released under the MIT License.