- How do I install robertboes/inertia-breadcrumbs in a Laravel application?
- Install it with Composer using composer require robertboes/inertia-breadcrumbs, then follow the package documentation for any required middleware registration or configuration publishing. The package is designed to share breadcrumb trails with Inertia, so you also need an existing Laravel application with Inertia.js set up. Confirm the supported PHP, Laravel, and Inertia versions in the package metadata before rolling it out.
- How do I define breadcrumbs in routes or controllers?
- You define breadcrumb trails using the package API in your Laravel routes or controllers, then the package shares them with Inertia as page props. The exact syntax depends on the package version, so check the README or source for the supported helper or facade calls. Keep breadcrumb definitions close to the route or controller responsible for the page so the trail stays maintainable.
- Does it work with Vue, React, and Svelte Inertia pages?
- Yes. The package shares breadcrumbs as Inertia props, so Vue, React, and Svelte pages can render the same server-defined trail. You will still need to build or adapt the presentational breadcrumb component in your frontend framework. The package handles the Laravel-to-Inertia data sharing, not the visual styling.
- Which Laravel, PHP, and Inertia versions are supported?
- The provided context does not list exact version constraints, so check the package composer.json and release notes before installation. Release 1.2.0 is described as additive and semver-minor with no breaking changes indicated, but you should still confirm PHP, Laravel, Inertia, and Laravel Boost compatibility for your stack. Test the upgrade in a branch before production rollout.
- Do I need Laravel Boost to use robertboes/inertia-breadcrumbs 1.2.0?
- No. The Laravel Boost guideline and skill support added in 1.2.0 is developer-experience tooling, not a runtime requirement for breadcrumb rendering. You can use the package without installing Boost. If your team does adopt Boost, pilot the guideline with one developer before standardizing it.
- Is version 1.2.0 a breaking change?
- The release is described as additive and semver-minor, with no breaking changes indicated. Its main new feature is Laravel Boost AI guideline and skill support, which should not alter breadcrumb rendering or Inertia page contracts. Still review the changelog and PR #35 and run your test suite before upgrading.
- How should I test breadcrumbs after upgrading?
- Update the dependency in a non-production branch, run your application test suite, and smoke-test breadcrumbs across representative Inertia pages. Assert that the expected breadcrumb props are present for key routes and nested navigation. If you use Boost-generated code, review it as normal application code rather than trusting it automatically.
- Is this package safe for production and does it affect performance?
- The runtime behavior is request-scoped breadcrumb generation and sharing with Inertia, so no material scaling impact is expected. The Boost guideline and skill are development tooling; validate that any Boost assets remain development-only and do not affect production builds. Use code review and tests to catch missing or incorrect breadcrumbs on new pages.
- How do I handle nested breadcrumb navigation?
- The package is described as supporting nested navigation, so you can define parent and child trails and share them as Inertia props. Keep the nesting logic in your Laravel route or controller definitions and render the hierarchy in your frontend breadcrumb component. Add tests for deeper pages so the trail remains correct as routes change.
- What are the maintenance concerns or alternatives to this package?
- Runtime maintenance is described as low, but the new AI guideline and skill introduce a small documentation and tooling ownership requirement so guidance stays aligned with package and application conventions. Alternatives include implementing your own Inertia-shared breadcrumb middleware or adapting another Laravel breadcrumb package, but evaluate fit with Inertia props and nesting. Choose this package when you want server-driven breadcrumb definitions shared directly with Vue, React, or Svelte Inertia pages.