PHPackages                             nowo-tech/breadcrumb-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. [Localization &amp; i18n](/categories/localization)
4. /
5. nowo-tech/breadcrumb-kit-bundle

ActiveSymfony-bundle[Localization &amp; i18n](/categories/localization)

nowo-tech/breadcrumb-kit-bundle
===============================

Symfony bundle: configurable breadcrumb trails (route matching, i18n, optional links, collection-level presentation).

v2.1.3(2w ago)0343[2 PRs](https://github.com/nowo-tech/BreadcrumbKitBundle/pulls)MITPHPPHP &gt;=8.2 &lt;8.6CI passing

Since Jul 3Pushed 1mo agoCompare

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

READMEChangelog (6)Dependencies (55)Versions (26)Used By (0)

Breadcrumb Kit Bundle
=====================

[](#breadcrumb-kit-bundle)

[![CI](https://github.com/nowo-tech/BreadcrumbKitBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/BreadcrumbKitBundle/actions/workflows/ci.yml)[![Packagist Version](https://camo.githubusercontent.com/4a15b38cbce1adae9abec7fcbeb0d061d0af10ce9a83f0e26ee50194be56a9ff/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f62726561646372756d622d6b69742d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/breadcrumb-kit-bundle)[![Packagist Downloads](https://camo.githubusercontent.com/2aa38079d6087ce5befda59637587f2b19811f9e3e8c6d55167cb515d2f995b4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f62726561646372756d622d6b69742d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/breadcrumb-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/1bb6ebaf6a555f96b1957e20fb1039345575167e266b78075acc7e1bf1b17273/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e78253230253743253230382e782d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com)[![GitHub stars](https://camo.githubusercontent.com/5645097e4fa4e60cf841d48a2b703f2ecac2c5249b56aeb654a8116f1ddb2463/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f42726561646372756d624b697442756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/BreadcrumbKitBundle)[![Coverage](https://camo.githubusercontent.com/b1ff87ba846bd3901c24e2a5d7631db4676c32d855472ce028aef3a4f3e55d76/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d39392e35322532352d627269676874677265656e)](#tests-and-coverage)

> ⭐ **Found this useful?** Install from [Packagist](https://packagist.org/packages/nowo-tech/breadcrumb-kit-bundle) and consider starring the [GitHub repository](https://github.com/nowo-tech/BreadcrumbKitBundle).

Symfony bundle for **database-driven breadcrumb trails**: match the current route by name + static parameters, walk a **parent chain**, support **i18n** (JSON translations on entities), **optional links**, per-**collection** presentation (icons, CSS, responsive JSON), and **PSR-6 caching** of serialized item rows.

Design aligns with [DashboardMenuBundle](https://github.com/nowo-tech/DashboardMenuBundle) (Doctrine, YAML defaults, cache pool, Twig namespace overrides).

Version information
-------------------

[](#version-information)

Latest release: **[v2.0.1](https://github.com/nowo-tech/BreadcrumbKitBundle/releases/tag/v2.0.1)** (2026-07-05). Requires **PHP 8.2+** and **Symfony 7+**. Tables: `dashboard_breadcrumb_*` (see [UPGRADING.md](docs/UPGRADING.md) from v1.2.x).

Status
------

[](#status)

**MVP (v2.0.1):** entities (`dashboard_breadcrumb_*` tables, aligned with DashboardMenuBundle), repositories, `BreadcrumbLoader`, `BreadcrumbUrlResolver`, Twig (`breadcrumb_trail`, `breadcrumb_render`), **optional web dashboard**, **presentation options**, dashboard i18n **en/es/de/fr/it/nl/pt**. **Demos**: Symfony 7 (**8020**) and Symfony 8.1 (**8021**) with FrankenPHP. **Flex recipe** in `.symfony/recipe/`. Planned: migration command, event-based enrichers.

**FrankenPHP worker mode:** demos use worker-enabled `Caddyfile` for production-style runs; development uses `Caddyfile.dev` without workers. See [docs/DEMO-FRANKENPHP.md](docs/DEMO-FRANKENPHP.md).

Requirements
------------

[](#requirements)

- PHP `>=8.2  ['all' => true],
```

With **Symfony Flex**, the recipe (when available from Packagist or your recipe index) registers the bundle and adds config/routes. Without Flex, see [docs/INSTALLATION.md](docs/INSTALLATION.md) for manual steps.

Example `config/packages/nowo_breadcrumb_kit.yaml`:

```
nowo_breadcrumb_kit:
    locales: ['en', 'es']
    default_locale: 'en'
    default_collection: 'default'
    cache:
        ttl: 60
        pool: cache.app
```

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

[](#documentation)

- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.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)

### Additional documentation

[](#additional-documentation)

- [DEMO-FRANKENPHP.md](docs/DEMO-FRANKENPHP.md) — FrankenPHP demos (`demo/symfony7`, `demo/symfony8`)

### Demo applications

[](#demo-applications)

**Symfony 7** (default):

```
make -C demo/symfony7 up
```

Opens at `http://localhost:8020` (see `demo/symfony7/.env.example` → `PORT`).

**Symfony 8** (Symfony 8.1, PHP 8.4):

```
make -C demo/symfony8 up
```

Opens at `http://localhost:8021` by default; the app redirects `/` to `/en/`.

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

[](#tests-and-coverage)

- **PHP**: run `composer test-coverage` or `make test-coverage` (Docker). Update the percentage below when you change code or tests; CI enforces a green build and generates `coverage.xml`.

LanguageCoverage (Lines / notes)PHP**99.52%** (Lines, PHPUnit + PCOV; run `make test-coverage` to refresh)TS/JSN/APythonN/ADevelopment
-----------

[](#development)

```
composer install
composer test
composer phpstan
```

With Docker from the bundle root:

```
make install
make test-coverage
```

License
-------

[](#license)

MIT. See [LICENSE](LICENSE).

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance93

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 81% 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 ~1 days

Total

23

Last Release

17d ago

Major Versions

v1.2.1 → v2.0.02026-07-05

### 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 (17 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (1 commits)")

---

Tags

symfonyi18nnavigationSymfony Bundlebreadcrumb

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M430](/packages/easycorp-easyadmin-bundle)[sylius/sylius

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

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

Contao Open Source CMS

1301.7M3.1k](/packages/contao-core-bundle)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M676](/packages/shopware-core)[chameleon-system/chameleon-base

The Chameleon System core.

1029.4k6](/packages/chameleon-system-chameleon-base)[sulu/sulu

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

1.3k1.4M236](/packages/sulu-sulu)

PHPackages © 2026

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