PHPackages                             nowo-tech/auth-kit-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. nowo-tech/auth-kit-bundle

ActiveSymfony-bundle[Authentication &amp; Authorization](/categories/authentication)

nowo-tech/auth-kit-bundle
=========================

Symfony bundle for configurable login and registration with overridable templates, registration modes, and i18n

v1.5.1(2w ago)019MITPHPPHP &gt;=8.2 &lt;8.6CI passing

Since Jun 18Pushed 1w agoCompare

[ Source](https://github.com/nowo-tech/AuthKitBundle)[ Packagist](https://packagist.org/packages/nowo-tech/auth-kit-bundle)[ Docs](https://github.com/nowo-tech/AuthKitBundle)[ GitHub Sponsors](https://github.com/HecFranco)[ RSS](/packages/nowo-tech-auth-kit-bundle/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (47)Versions (13)Used By (0)

Auth Kit Bundle
===============

[](#auth-kit-bundle)

[![CI](https://github.com/nowo-tech/AuthKitBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/AuthKitBundle/actions/workflows/ci.yml) [![Packagist Version](https://camo.githubusercontent.com/4d0146278383ca340d35a5424c80b367efa44c62f96094a58adf03616e47d029/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f617574682d6b69742d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/auth-kit-bundle) [![Packagist Downloads](https://camo.githubusercontent.com/0c9a6cb520ea76f9c3d6e9007df202d1fe49a4c8f93432d554bc0a224a0efa53/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f617574682d6b69742d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/auth-kit-bundle) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/0701ae1a8855b98dea0f1dc9d9025d6b0f9444a803559dc983614d044176348b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e34253230253743253230382e30253230253743253230382e312532422d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) [![GitHub stars](https://camo.githubusercontent.com/478c0dececfea023574626dc0310ece9b2a4e86bf0b0a036f2d26d31e5e11968/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f417574684b697442756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/AuthKitBundle) [![Coverage](https://camo.githubusercontent.com/cd0704b56f1d56def350b6d0164316307bb2f47834225fd85443b6fb0059bc73/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d3130302532352d627269676874677265656e)](#tests-and-coverage)

> ⭐ **Found this useful?** Install from [Packagist](https://packagist.org/packages/nowo-tech/auth-kit-bundle) and give the repo a star on GitHub.

Symfony bundle for **configurable login, registration, and password reset**: overridable Twig templates, registration modes (`disabled`, `first_user_only`, `always`), optional embeddable auth dropdown, locale-prefixed routes, assignable registration role, configurable user entity and form fields, built-in routes, and translations (`de`, `en`, `es`, `fr`, `it`, `nl`, `pt`).

Works alongside Symfony Security — `security.yaml` remains required and is documented in [INSTALLATION.md](docs/INSTALLATION.md) with optional CLI helper `nowo:auth-kit:configure-security`.

[![FrankenPHP Friendly Worker Mode](docs/images/frankenphp-friendly.png)](docs/images/frankenphp-friendly.png)

This bundle is **FrankenPHP worker mode friendly**.

Features
--------

[](#features)

- Login page compatible with Symfony `form_login`
- Registration with Doctrine persistence and password hashing
- **Password reset** (link, code, or both) with pluggable notifier
- **Magic login** (passwordless email link via Symfony `login_link`)
- **Embedded auth dropdown** (`auth_kit_dropdown()`) for navbars and layouts
- **Locale in URL paths** (`/en/login`, `/es/register`, …)
- **Remember me** (optional persistent login cookie)
- **Password strength** (optional integration with `nowo-tech/password-strength-bundle`)
- Registration modes: disabled, first user only, always open
- **Named profiles** — separate auth config per user entity (`User`, `Admin`, …) with O(1) class resolution
- Configurable `user_class`, identifier field, login/register fields, role, routes, templates
- Twig overrides via `templates/bundles/NowoAuthKitBundle/`
- Translation domain `NowoAuthKitBundle` with app overrides (`de`, `en`, `es`, `fr`, `it`, `nl`, `pt`)

Installation
------------

[](#installation)

```
composer require nowo-tech/auth-kit-bundle
```

```
# config/packages/nowo_auth_kit.yaml
nowo_auth_kit:
    default_profile: default
    profiles:
        default:
            user_class: App\Entity\User
            user_identifier_field: email
            registration_mode: first_user_only
            registration_role: ROLE_USER
```

The legacy flat layout (`user_class` at root) remains supported. See [Configuration](docs/CONFIGURATION.md).

```
php bin/console nowo:auth-kit:configure-security
```

Development
-----------

[](#development)

```
make up
make test
make release-check
```

Demo
----

[](#demo)

```
make -C demo up-symfony8   # Symfony 8.1 — http://localhost:8010
```

Register the first user, then try password login, **password reset**, **magic login**, and **dual locale URLs** (`/en/login` and bare `/login` → redirect). The demo includes **Bootstrap 5** UI overrides, embed dropdown, a session **delivery inbox** (no mailer), and FrankenPHP (Docker).

### Screenshots

[](#screenshots)

 [![Welcome page with locale switcher and Account dropdown](docs/assets/demo-welcome.png)](docs/assets/demo-welcome.png) [![Full-page login at /en/login](docs/assets/demo-login.png)](docs/assets/demo-login.png) [![Embedded sign-in in navbar dropdown](docs/assets/demo-embed-dropdown.png)](docs/assets/demo-embed-dropdown.png)

Welcome · Login · `auth_kit_dropdown()`

See [demo/README.md](demo/README.md) for template override paths and [docs/DEMO-FRANKENPHP.md](docs/DEMO-FRANKENPHP.md) for FrankenPHP setup (including **worker mode** for production).

Tests and coverage
------------------

[](#tests-and-coverage)

- Tests: PHPUnit (unit + integration)
- PHP: 100%
- TS/JS: N/A
- Python: N/A

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

Documentation
-------------

[](#documentation)

- [GitHub Actions CI requirements](docs/GITHUB_CI.md)
- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Changelog](docs/CHANGELOG.md)
- [Upgrading](docs/UPGRADING.md)
- [Release](docs/RELEASE.md)
- [Security](docs/SECURITY.md)
- [Engram](docs/ENGRAM.md)
- [Spec-driven development](docs/SPEC-DRIVEN-DEVELOPMENT.md)
- [GitHub Spec Kit](docs/SPEC-KIT.md)

### Additional documentation

[](#additional-documentation)

- [Password reset](docs/PASSWORD-RESET.md)
- [Magic login](docs/MAGIC-LOGIN.md)
- [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md)

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance97

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

12

Last Release

17d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7947bfc3f2ce9574a18a2c60f3d95b5d1b0740e65dc929332c92f1df21f75ab?d=identicon)[HecFranco](/maintainers/HecFranco)

---

Top Contributors

[![HecFranco](https://avatars.githubusercontent.com/u/24323276?v=4)](https://github.com/HecFranco "HecFranco (37 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")

---

Tags

symfonybundlesecurityauthAuthenticationloginregistration

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nowo-tech-auth-kit-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nowo-tech-auth-kit-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-auth-kit-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M413](/packages/easycorp-easyadmin-bundle)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1617.3k14](/packages/2lenet-crudit-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k6.0M763](/packages/sylius-sylius)[contao/core-bundle

Contao Open Source CMS

1301.7M2.9k](/packages/contao-core-bundle)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M221](/packages/sulu-sulu)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.9M529](/packages/pimcore-pimcore)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
