Weave Code
Weaver
Helps Laravel developers discover, compare, and choose open-source packages. See popularity, security, maintainers, and scores at a glance to make better decisions.
Feedback
Share your thoughts, report bugs, or suggest improvements.
Subject
Message
Breadcrumbs Bundle

Breadcrumbs Bundle Laravel Package

huluti/breadcrumbs-bundle

Huluti Breadcrumbs Bundle provides configurable breadcrumb navigation for Symfony applications. Define trails in PHP or YAML, connect them to routes, and render accessible breadcrumbs in Twig templates with minimal setup and flexible customization.

View on GitHub
Deep Wiki
Context7

huluti/breadcrumbs-bundle is a lightweight PHP bundle for building and rendering breadcrumb navigation in your application. Define breadcrumb trails declaratively and let the bundle assemble hierarchical links from your routes or configuration, keeping templates clean and navigation consistent across every page.

  • Declarative trails — define crumbs once instead of hardcoding markup in each template
  • Twig rendering — output a ready-to-style breadcrumb list with a single call
  • Bootstrap-friendly markup — sensible default templates that are easy to override
  • Route-aware — generate links from route names and parameters
  • Extensible — plug in custom builders or templates as needed
Frequently asked questions about Breadcrumbs Bundle
Can I use huluti/breadcrumbs-bundle in a Laravel application?
Not as a drop-in dependency. huluti/breadcrumbs-bundle is a Symfony bundle, so it ships no Laravel service provider, facade, or package discovery manifest, and it is built around Symfony's kernel, DI container extension, and Twig conventions. You could technically instantiate its service classes by hand or wrap it in a shim service provider, but for a feature this small the shim costs more than it saves. The practical path for Laravel is to read the source as a reference and port the trail-building logic into your own service.
What Laravel package should I use for breadcrumbs instead?
diglactic/laravel-breadcrumbs is the closest equivalent and is designed for Laravel's routing, service container, and Blade. A roughly 150-line in-house implementation, with a BreadcrumbService that pushes label and url pairs, a route-based resolver, and a Blade component, delivers the same value with no third-party dependency. Breadcrumbs are a solved problem; the differentiator between options is maintenance burden, not capability.
What is huluti/breadcrumbs-bundle a fork of, and why does that matter?
It is a fork of mhujer/BreadcrumbsBundle, kept alive for newer Symfony and PHP versions. That means API and config conventions you find in older tutorials for mhujer's bundle should largely carry over. It also means the project inherits a low-traffic maintenance model: one maintainer, a handful of stars, and no dependents applying ecosystem pressure. Check the tag history and open issues before committing.
Which Symfony and PHP versions does huluti/breadcrumbs-bundle support?
The package is described as maintained for newer Symfony and PHP releases, which is the whole reason the fork exists. Exact constraints live in its composer.json, so read the require block for the php, symfony/framework-bundle, and twig/twig version ranges before you plan an upgrade. One assessment flag: the listed last-release date of 2026-03-04 is in the future, so verify recency against the actual tags rather than trusting a single metadata field.
How do I install and configure huluti/breadcrumbs-bundle in Symfony?
Install it with composer require huluti/breadcrumbs-bundle, then register the bundle in config/bundles.php the way you would any Symfony bundle. Configuration goes in config/packages/ under the bundle's config key, and breadcrumb trails are defined either in configuration or in a service that builds them at runtime. Rendering happens in your Twig templates using the bundle's provided template or your own override.
Does it handle dynamic, entity-derived breadcrumb trails or only static ones?
The bundle supports both manually defined custom trails and trails generated from routes, which covers most catalogue, blog, and documentation hierarchies. Where the real implementation cost lives is entity-derived trails, for example Category to Subcategory to Product, where each segment comes from a database record. Confirm in the source whether the bundle resolves that hierarchy for you or expects you to hand it a pre-built trail; if it expects the latter, you are writing the resolver either way.
Is the rendering Twig-only, or can I get breadcrumbs as data for Blade or an API?
The bundle is built for Symfony and renders through templates, so Twig is the intended output path. If you need a plain array of label and url pairs for a Blade component or a JSON response, check whether the builder service exposes the trail as objects you can iterate before rendering. For a Laravel app, the cleanest route is to build that array yourself and skip the bundle's rendering layer entirely.
Is huluti/breadcrumbs-bundle actively maintained and safe to use in production?
It is MIT licensed, so there is no legal friction, and the fork exists specifically to keep it working on current Symfony and PHP. The caution signals are scale, not code: roughly 9 stars, 0 dependents, a single maintainer, and therefore a bus factor of one. That is acceptable for a small, well-understood feature, but pin the version, read the source, and keep a fallback plan so a stale release never blocks a framework upgrade.
How do I test breadcrumbs in a Laravel or Symfony application?
Test the trail builder and the rendered output separately. Unit-test the builder by asserting the expected label and url sequence for a given route or entity hierarchy, then feature-test the page and assert the breadcrumb markup and ordering. In Laravel, assertSeeInOrder against the rendered Blade output is enough; in Symfony, do the same against the Twig response. Both are fast tests and they catch the regressions that actually matter: wrong ordering, missing segments, and broken links.
Does huluti/breadcrumbs-bundle generate Schema.org BreadcrumbList structured data for SEO?
It renders breadcrumb navigation through customizable templates, so the output is crawlable link-and-hierarchy markup, which is the SEO-friendly part. The documentation describes template rendering rather than built-in JSON-LD emission, so plan to add a BreadcrumbList script block in your template or layout. Whichever framework you use, the structured data is a few lines of Twig or Blade on top of the trail the bundle already gives you.
Weaver

How can I help you explore Laravel packages today?

Conversation history is not saved when not logged in.
Prompt
Add packages to context
No packages found.
jinas/dhivatar
store-doc/laravel-storage-driver
plus-it/laravel-translation-manager
diephp/perhaps
diephp/telegraph
osmaviation/spreadsheet
microsoft/fluentui-system-icons
mmccook/php-json-canonicalization-scheme
middlewares/firewall
qubiqx/montapacking
nyoncode/laravel-package-console
pnscripts/filament-broadquill-lite
pnscripts/laravel-sentfold-lite
vleap/mx-sdk-laravel-internal
twidpay/utils
htetmyathlaing/scout-elasticsearch-driver
artisan-toolbox/front-awesome
ls/client-assistant
users-au/laravel-client
cgv/localized-resource