PHPackages                             marshmallow/breadcrumb - 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. [Templating &amp; Views](/categories/templating)
4. /
5. marshmallow/breadcrumb

ActiveLibrary[Templating &amp; Views](/categories/templating)

marshmallow/breadcrumb
======================

A package for Laravel Breadcrum usage with the ability to add some default and use your custom templating

v2.0.1(5y ago)011.1k↓73.3%[1 PRs](https://github.com/marshmallow-packages/breadcrumb/pulls)1MITPHPPHP ^7.0|^8.0CI passing

Since Apr 3Pushed 2w ago1 watchersCompare

[ Source](https://github.com/marshmallow-packages/breadcrumb)[ Packagist](https://packagist.org/packages/marshmallow/breadcrumb)[ Docs](https://github.com/Marshmallow-Development/)[ RSS](/packages/marshmallow-breadcrumb/feed)WikiDiscussions main Synced 2d ago

READMEChangelogDependencies (1)Versions (9)Used By (1)

[![alt text](https://camo.githubusercontent.com/329958cb02b7bee461fd9dcae7a0a3a34e6595669116ff441ad5ef9e77bc511c/68747470733a2f2f63646e2e6d617273686d616c6c6f772d6f66666963652e636f6d2f6d656469612f696d616765732f6c6f676f2f6d617273686d616c6c6f772e7472616e73706172656e742e7265642e706e67 "marshmallow.")](https://camo.githubusercontent.com/329958cb02b7bee461fd9dcae7a0a3a34e6595669116ff441ad5ef9e77bc511c/68747470733a2f2f63646e2e6d617273686d616c6c6f772d6f66666963652e636f6d2f6d656469612f696d616765732f6c6f676f2f6d617273686d616c6c6f772e7472616e73706172656e742e7265642e706e67)

Laravel Breadcrumb
==================

[](#laravel-breadcrumb)

[![Latest Version on Packagist](https://camo.githubusercontent.com/e42c8d075072e99652aa5263b551cf10eab07017aaf6853270694e9a8b22adaf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d617273686d616c6c6f772f62726561646372756d622e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/marshmallow/breadcrumb)[![Total Downloads](https://camo.githubusercontent.com/4ae43c2bfbf48b00ede8fa9ba2ce380feef0df33bb757f73fb5b433e5d60be11/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d617273686d616c6c6f772f62726561646372756d622e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/marshmallow/breadcrumb)

Laravel Breadcrumb makes it easy to generate breadcrumbs in your Laravel application. You can configure a default crumb, add crumbs on the fly, and render them through fully publishable Blade templates. If you also use our [Seoable](https://github.com/marshmallow-packages/seoable) package, it will generate the breadcrumb structured-data JSON for you automatically.

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

[](#installation)

Install the package via Composer:

```
composer require marshmallow/breadcrumb
```

The service provider and the `Breadcrumb` facade alias are registered automatically through Laravel package discovery.

Publish the config file:

```
php artisan vendor:publish --tag="config" --provider="Marshmallow\Breadcrumb\BreadcrumbServiceProvider"
```

Publish the Blade views so you can change the markup to your liking:

```
php artisan vendor:publish --provider="Marshmallow\Breadcrumb\BreadcrumbServiceProvider"
```

The views are published to `resources/views/vendor/marshmallow/breadcrumb`.

Usage
-----

[](#usage)

### Add a crumb

[](#add-a-crumb)

Use the `Breadcrumb` facade to add a crumb. The icon class is optional.

```
use Marshmallow\Breadcrumb\Facades\Breadcrumb;

Breadcrumb::add('Blog', '/blog');
Breadcrumb::add('My article', '/blog/my-article', 'fas fa-newspaper');
```

A default crumb (configured under `breadcrumb.default`) is added for you when the breadcrumb is resolved, so you usually only add the crumbs that come after it.

### Add multiple crumbs

[](#add-multiple-crumbs)

You can build `Crumb` instances yourself and add them in bulk:

```
use Marshmallow\Breadcrumb\Crumb;
use Marshmallow\Breadcrumb\Facades\Breadcrumb;

Breadcrumb::addCrumbs([
    Crumb::make('Blog', '/blog'),
    Crumb::make('My article', '/blog/my-article'),
]);
```

The `Crumb` class also lets you resolve the URL from a named route and set an icon:

```
use Marshmallow\Breadcrumb\Crumb;

$crumb = Crumb::make('My article', '/blog/my-article')
    ->setRoute('blog.show', ['article' => $article])
    ->setIconClass('fas fa-newspaper');
```

When a crumb's URL matches the current request, it is automatically flagged as the current (active) crumb.

### Render the breadcrumbs

[](#render-the-breadcrumbs)

Render the breadcrumbs in your Blade view:

```
{!! Breadcrumb::generate() !!}
```

Configuration
-------------

[](#configuration)

After publishing, the configuration lives in `config/breadcrumb.php`.

KeyDefaultDescription`default.name``'Home'`Name of the default crumb prepended to every breadcrumb.`default.url``env('APP_URL')`URL of the default crumb.`default.icon``'fas fa-home'`Icon class of the default crumb.`view``'marshmallow::breadcrumb.container'`The view used to render the breadcrumb.`classes.container``'breadcrumb-container'`CSS class for the container element.`classes.list``'breadcrumb-list'`CSS class for the list element.`classes.item``'breadcrumb-item'`CSS class for each item.`classes.link``'breadcrumb-link'`CSS class for each link.`classes.icon``'breadcrumb-icon'`CSS class for each icon.`classes.active_item``'active-item'`CSS class for the active item.`classes.active_link``'active-link'`CSS class for the active link.Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please report security vulnerabilities by email to  rather than via the public issue tracker.

Credits
-------

[](#credits)

- [Stef](https://marshmallow.dev)
- [All Contributors](https://github.com/marshmallow-packages/breadcrumb/contributors)

License
-------

[](#license)

The MIT License. Please see the [License File](LICENSE) for more information.

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance63

Regular maintenance activity

Popularity23

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 82.8% 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 ~123 days

Total

4

Last Release

1914d ago

Major Versions

v1.0.3 → v2.0.02020-12-29

PHP version history (2 changes)v1.0.2PHP &gt;=7.0.0

v2.0.1PHP ^7.0|^8.0

### Community

Maintainers

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

---

Top Contributors

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

---

Tags

marshmallow

### Embed Badge

![Health badge](/badges/marshmallow-breadcrumb/health.svg)

```
[![Health](https://phpackages.com/badges/marshmallow-breadcrumb/health.svg)](https://phpackages.com/packages/marshmallow-breadcrumb)
```

###  Alternatives

[limenius/react-bundle

Client and Server-side react rendering in a Symfony Bundle

3851.2M](/packages/limenius-react-bundle)[jelix/wikirenderer

WikiRenderer is a library to generate HTML or anything else from wiki content.

1712.3k1](/packages/jelix-wikirenderer)[webkinder/sproutset

A Composer package for handling responsive images in Roots Bedrock + Sage + Blade projects.

282.2k](/packages/webkinder-sproutset)

PHPackages © 2026

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