nowo-tech / otp-input-bundle

v1.5.0 2026-09-03 22:11 UTC

Requires

• php: >=8.2 <8.6
• symfony/config: ^6.0 || ^7.0 || ^8.0
• symfony/dependency-injection: ^6.0 || ^7.0 || ^8.0
• symfony/form: ^6.0 || ^7.0 || ^8.0
• symfony/framework-bundle: ^6.0 || ^7.0 || ^8.0
• symfony/http-kernel: ^6.0 || ^7.0 || ^8.0
• symfony/twig-bundle: ^6.0 || ^7.0 || ^8.0
• twig/extra-bundle: ^3.12
• twig/string-extra: ^3.12

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• nowo-tech/phpstan-frankenphp: ^1.0
• phpstan/extension-installer: ^1.0
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpstan/phpstan-symfony: ^2.0
• phpunit/phpunit: ^11.0
• rector/rector: ^2.0
• symfony/browser-kit: ^6.0 || ^7.0 || ^8.0
• symfony/dom-crawler: ^6.0 || ^7.0 || ^8.0
• symfony/yaml: ^6.0 || ^7.0 || ^8.0
• vincentlanglet/twig-cs-fixer: ^4.0

MIT

• Héctor Franco Aceituno
• Nowo.tech

• symfony
• form
• otp
• one-time-password
• 2fa
• form-type
• symfony-bundle
• typescript
• vite

Published on Packagist.org on 2026-09-03 22:11 UTC

README

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

Customizable Symfony OTP FormType with multiple visible inputs that map to a single field value.

This bundle is FrankenPHP worker mode friendly.

Table of contents

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

Features

• OtpType::class for verification codes (2FA, email confirmation, magic code).
• Multi-input UI rendered in Twig form themes.
• Stores data as one string value in your DTO/entity.
• Customizable length, classes, numeric/alphanumeric mode, and uppercase normalization.
• TypeScript + Vite assets in src/Resources/assets (named package nowo_otp_input).
• Paste / autofill (autocomplete="one-time-code"); translations de, en, es, fr, it, nl, pt.
• Multi-framework Twig themes (Bootstrap, Tailwind, Foundation, Symfony default).

Quick usage

use Nowo\OtpInputBundle\Form\OtpType;

$builder->add('otpCode', OtpType::class, [
    'length' => 6,
    'numeric_only' => true,
    'container_class' => 'd-flex gap-2',
    'input_class' => 'form-control text-center',
    'gap_class' => 'otp-grid',
]);

The value received in otpCode is a single string like 123456.

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