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

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).