nowo-tech/cookie-consent-bundle

Symfony bundle providing a GDPR cookie consent modal with category toggles and optional consent logging

v1.2.0 2026-06-16 09:38 UTC

Requires

• php: >=8.1 <8.6
• doctrine/doctrine-bundle: ^2.10 || ^3.0
• doctrine/orm: ^2.15 || ^3.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/routing: ^6.0 || ^7.0 || ^8.0
• symfony/translation: ^6.0 || ^7.0 || ^8.0
• symfony/twig-bundle: ^6.0 || ^7.0 || ^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpstan/phpstan-symfony: ^2.0
• phpunit/phpunit: ^10.0
• rector/rector: ^2.0
• symfony/var-exporter: ^6.4 || ^7.0 || ^8.0
• symfony/yaml: ^6.0 || ^7.0 || ^8.0

MIT

• Héctor Franco Aceituno
• Nowo.tech

• symfony
• bundle
• cookie
• modal
• privacy
• consent
• gdpr

README

⭐ Found this useful? Install from Packagist · Give it a star on GitHub so more developers can find it.

Symfony bundle that renders a GDPR cookie consent modal with category toggles, optional per-cookie selection, cookie inventory, AJAX form submission, optional consent logging, and configurable Doctrine table prefix.

Frontend behavior is implemented in TypeScript and built with Vite (make assets → src/Resources/public/nowo-consent-modal.js).

Documentation

• Installation
• Configuration
• Usage
• Contributing
• Changelog
• Upgrading
• Release
• Security
• Engram
• Spec-driven development

Additional documentation

• Demo with FrankenPHP

Quick start

composer require nowo-tech/cookie-consent-bundle

# config/packages/nowo_cookie_consent.yaml
nowo_cookie_consent:
    table_prefix: 'app_'   # optional; yields app_nowo_cookie_consent_log
    use_logger: true

{# templates/base.html.twig #}
{% if nowo_cookie_consent_should_embed_modal() %}
    {{ render(path('nowo_cookie_consent.show_if_not_set')) }}
{% endif %}

Install public assets:

php bin/console assets:install

Demo

make -C demo up-symfony8
# Bootstrap demo: http://localhost:8014

make -C demo up-symfony8-tailwind
# Tailwind demo: http://localhost:8015

• demo/symfony8/ — FrankenPHP Symfony 8 app with Bootstrap 5
• demo/symfony8-tailwind/ — same demo with Tailwind CSS and ui_theme: tailwind

See Demo with FrankenPHP for development vs. production worker mode.

Tests and coverage

Language	Lines (approx.)	Command
PHP	~100%	make test-coverage
TypeScript	~94%	make test-ts

make test
make test-coverage
make test-ts
make assets
make release-check

PHP coverage target is ~100% (currently ~100%; see Release); exclusions must be justified in phpunit.xml.dist. TypeScript coverage enforces a minimum of 90% (Vitest thresholds + .scripts/ts-coverage-percent.sh).