step2dev/lazy-breadcrumb

🧭 Lazy Breadcrumb

A modern, developer-first breadcrumb generator for Laravel with Blade components, SEO-ready JSON-LD, Artisan tooling, and flexible DSL/macros.

🚀 Installation

composer require step2dev/lazy-breadcrumb

Optional: Publish config and views

php artisan vendor:publish --tag=lazy-breadcrumb-config
php artisan vendor:publish --tag=lazy-breadcrumb-views

✨ Features

• Breadcrumbs::for() API
• Blade components (<x-breadcrumbs />, <x-breadcrumbs-json-ld />)
• Auto-title support: $trail->model($model)
• Custom push: $trail->push('Title', 'url')
• Replacing last item: $trail->replaceLast('New Title')
• Copy parent trail: $trail->import([...])
• Macro support: Breadcrumbs::macro('key', fn ($trail) => ...)
• SEO-ready: JSON-LD output for search engines
• Auto-discovery: optional route:breadcrumbs:sync
• Full Artisan tooling

📌 Defining Breadcrumbs

Create a routes/breadcrumbs.php file:

use Step2dev\LazyBreadcrumb\Breadcrumbs;
use Step2dev\LazyBreadcrumb\Breadcrumbs\Trail;

Breadcrumbs::for('dashboard', function (Trail $trail) {
    $trail->push(__('Dashboard'), route('dashboard'));
});

Breadcrumbs::for('profile', function (Trail $trail) {
    $trail->push(__('Dashboard'), route('dashboard'))
          ->push(__('Profile'), route('profile'));
});

You can also use:

$trail->model($user); // Auto title from $user->name, title, or slug
$trail->replaceLast('Editing');
$trail->import([...]); // Reuse a parent breadcrumb

🧩 Blade Components

Use directly in any view:

<x-breadcrumbs />
<x-breadcrumbs-json-ld /> {{-- SEO only --}}

To customize the view, publish and modify resources/views/components/breadcrumbs.blade.php.

🧪 Artisan Commands

🧠 View Sharing

To make breadcrumbs available globally:

// Middleware registration
\Step2dev\LazyBreadcrumb\Middleware\ShareBreadcrumbs::class

Then in views:

@foreach ($breadcrumbs as $crumb)
    <a href="{{ $crumb['url'] }}">{{ $crumb['title'] }}</a>
@endforeach

📦 Preset (Optional)

Register the service provider:

\Step2dev\LazyBreadcrumb\LazyBreadcrumbPresetServiceProvider::class

Then run:

php artisan preset lazy-breadcrumb

🧪 Testing

composer test

📝 License

MIT