PHPackages                             capell-app/navigation - 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. capell-app/navigation

ActiveLibrary

capell-app/navigation
=====================

Site- and language-scoped navigation menus for Capell: visual menu builder, page &amp; link items, nested dropdowns, active-state rendering, publish scheduling, and multi-site replication.

v1.0.19(2w ago)0222proprietaryPHPPHP ^8.4

Since Jul 9Pushed 2d agoCompare

[ Source](https://github.com/capell-app/navigation)[ Packagist](https://packagist.org/packages/capell-app/navigation)[ Docs](https://github.com/capell-app/navigation)[ RSS](/packages/capell-app-navigation/feed)WikiDiscussions 4.x Synced 1w ago

READMEChangelog (10)Dependencies (6)Versions (24)Used By (2)

Navigation
==========

[](#navigation)

What This Extension Adds
------------------------

[](#what-this-extension-adds)

Navigation is an **Available**, **Schema-owning** Capell package in the **Capell Foundation** product group. It ships as `capell-app/navigation` and extends these surfaces: admin, frontend, console.

Site- and language-scoped navigation menus for Capell: visual menu builder, page &amp; link items, nested dropdowns, active-state rendering, publish scheduling, and multi-site replication.

After install, admins get package-owned management surfaces and public users may see package-owned frontend output or routes.

Status details:

- Status: Available
- Tier: free
- Bundle: foundation
- Composer package: `capell-app/navigation`
- Namespace: `Capell\Navigation`
- Theme key: not applicable

Why It Matters
--------------

[](#why-it-matters)

**For developers:** The package gives developers package-owned service providers, Actions, Data objects, models, Laravel routes, Filament classes, and Blade views instead of pushing this behaviour into core or application code.

**For teams:** Build and manage multilingual, per-site menus visually - link to any page or URL, nest dropdowns, and render them in your theme with one tag. Active-state, publish windows, and site cloning included.

Screens And Workflow
--------------------

[](#screens-and-workflow)

Screenshot contract: `docs/screenshots.json`.

- Navigation admin index (admin, required).
- Create/edit navigation form (admin, required).
- Site relation manager for navigations (admin, required).
- Page form navigation tab (admin, required).
- Frontend menu output (frontend, required).

Technical Shape
---------------

[](#technical-shape)

- Service providers: `Capell\Navigation\Providers\NavigationServiceProvider`.
- Migrations: `packages/navigation/database/migrations/2026_05_10_190860_01_create_navigations_table.php`, `packages/navigation/database/migrations/2026_06_04_000001_create_navigation_page_references_table.php`.
- Models: `Navigation`.
- Filament classes: `TypeSelect`, `NavigationSelect`, `NavigationTab`, `NavigationItemsColumn`, `DefaultNavigationConfigurator`, `NavigationPageSchemaExtender`, `NavigationSiteExtender`, `NavigationResource`, `CreateNavigation`, `EditNavigation`, `ListNavigations`, `NavigationForm`, `and 2 more`.
- Route files: `packages/navigation/routes/web.php`.
- Policies: `NavigationPolicy`.
- Events: `NavigationCreating`.
- Listeners: `ReplicateSiteNavigationsListener`.
- Actions: `AddPageToNavigationAction`, `BuildNavigationBreadcrumbsAction`, `BuildNavigationChildFragmentAction`, `BuildNavigationRenderModelAction`, `BuildPageNavigationReferencesAction`, `EnsureNavigationItemKeysAction`, `RemovePageFromNavigationAction`, `ReplicateSiteNavigationsAction`, `ResolveNavigationItemModelsAction`, `SyncNavigationPageReferencesAction`.
- Data objects: `NavigationItemData`, `NavigationItemRenderData`, `NavigationRenderContextData`, `NavigationRenderData`.
- Command signatures: `capell:navigation-demo`, `capell:navigation-setup`.
- Console command classes: `DemoCommand`, `SetupCommand`.
- Manifest contributions: `admin-resource: Capell\Navigation\Manifest\NavigationAdminResourceContribution`, `configurator: Capell\Navigation\Manifest\NavigationConfiguratorContribution`, `configurator: Capell\Navigation\Manifest\NavigationContentGraphContribution`, `configurator: Capell\Navigation\Manifest\NavigationFrontendRuntimeContribution`, `console-command: Capell\Navigation\Manifest\NavigationConsoleCommandsContribution`, `frontend-component: Capell\Navigation\Manifest\NavigationFrontendComponentsContribution`, `health-check: Capell\Navigation\Manifest\NavigationHealthContribution`, `migration: Capell\Navigation\Manifest\NavigationMigrationsContribution`, `model: Capell\Navigation\Manifest\NavigationModelsContribution`, `page-type: Capell\Navigation\Manifest\NavigationPageTypeContribution`, `render-hook: Capell\Navigation\Manifest\NavigationRenderHookContribution`, `route: Capell\Navigation\Manifest\NavigationFrontendRouteContribution`, `schema-extender: Capell\Navigation\Manifest\NavigationSchemaExtendersContribution`.
- Health checks: `Capell\Navigation\Health\NavigationHealthCheck`.
- Blade views: `packages/navigation/resources/views/components/breadcrumbs.blade.php`, `packages/navigation/resources/views/components/header/main-navigation.blade.php`, `packages/navigation/resources/views/components/header/menu/dropdown.blade.php`, `packages/navigation/resources/views/components/header/menu/item.blade.php`, `packages/navigation/resources/views/components/header/navigation.blade.php`, `packages/navigation/resources/views/components/menu-items.blade.php`, `packages/navigation/resources/views/components/menu.blade.php`, `packages/navigation/resources/views/components/page/navigations.blade.php`.
- Cache tags: `navigation`.

Data Model
----------

[](#data-model)

- Required tables: `navigations`, `navigation_page_references`.
- Models: `Navigation`.
- Migration files: `2026_05_10_190860_01_create_navigations_table.php`, `2026_06_04_000001_create_navigation_page_references_table.php`.
- Migration impact: run host migrations through the package install flow before opening package surfaces.
- Deletion/retention behaviour: Docs gap unless the package has an explicit pruning command, retention setting, or tested cascade path.

Install Impact
--------------

[](#install-impact)

- Admin navigation: adds package-owned Filament classes when registered.
- Permissions: none declared in `capell.json`.
- Public routes: route files exist and must be reviewed before public enablement.
- Database changes: package migrations are declared.
- Settings: no package settings declared.
- Queues or schedules: none detected in standard package paths.
- Cache tags: `navigation`.
- Commands: `capell:navigation-demo`, `capell:navigation-setup`.

Common Pitfalls
---------------

[](#common-pitfalls)

- Run migrations before opening package resources or public routes.
- Review route middleware, throttling, signed URLs, and public-output safety before exposing routes.
- Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries.
- Run package commands from the host app; in this repository use `vendor/bin/pest` for package tests.
- Keep `composer.json`, `composer.local.json`, `capell.json`, docs, screenshots, and tests aligned when the package surface changes.

Troubleshooting
---------------

[](#troubleshooting)

SymptomLikely causeCheckFixPackage surface is missing after installProvider or manifest is not loadedConfirm `capell.json`, package `composer.json`, and provider registrationReinstall the package, refresh Composer autoload, and clear host cachesAdmin screen or command fails on missing tablePackage migrations have not runCheck the tables listed in `Data Model`Run host migrations and rerun the focused package testRoute returns unexpected outputRoute cache, middleware, or signed URL setup does not match the package route fileCheck the route files listed in `Technical Shape`Clear route cache and verify middleware before exposing public routesBackground work does not runQueue worker or scheduled command is not activeCheck package jobs, commands, and host scheduler configurationStart the queue or scheduler, then run the focused command or package testPublic output leaks unexpected stateRender data, cache variation, or authoring boundary has regressedCheck public Blade, cache tags, and public-output safety testsMove data loading out of Blade and rerun the package public-output testsQuick Start
-----------

[](#quick-start)

1. Install the package: `composer require capell-app/navigation`.
2. Run the required setup: `php artisan capell:navigation-setup`.
3. Open the related Capell admin surface and verify Navigation appears.

Next Steps
----------

[](#next-steps)

- [Package docs](docs/README.md)
- [Overview](docs/overview.md)
- [Screenshot contract](docs/screenshots.json)
- [Marketplace assets](docs/assets/marketplace/)
- [Capell content language plan](../../docs/CONTENT_LANGUAGE_PLAN.md)
- [Capell documentation design system](../../docs/DESIGN_SYSTEM.md)
- [Capell and package ERD notes](../../docs/erd/capell-and-package-erds.md)
- Focused tests: `vendor/bin/pest packages/navigation/tests --configuration=phpunit.xml`.

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance98

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~2 days

Total

19

Last Release

19d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/85b211531c530cd60c8e1b7b2c125c7e42192c820cde99fb6b201b1dde7a9d96?d=identicon)[capell-app](/maintainers/capell-app)

---

Top Contributors

[![capell-app-user](https://avatars.githubusercontent.com/u/213955377?v=4)](https://github.com/capell-app-user "capell-app-user (31 commits)")

---

Tags

capellcapell-cmsfilamentlaravellivewiremenu-buildermenusmulti-sitemultilingualmultisitenavigationphplaravelcmsnavigationfilamentphpcapell

### Embed Badge

![Health badge](/badges/capell-app-navigation/health.svg)

```
[![Health](https://phpackages.com/badges/capell-app-navigation/health.svg)](https://phpackages.com/packages/capell-app-navigation)
```

###  Alternatives

[lara-zeus/sky

Lara-zeus sky is simple CMS for your website. It includes posts, pages, tags, and categories.

21331.6k4](/packages/lara-zeus-sky)[riodwanto/superduper-filament-starter-kit

A comprehensive Laravel Filament 3 💡 starter kit with pre-installed plugins, admin panel, user management, SEO tools, theme customization, and content management for rapid application development

2818.7k](/packages/riodwanto-superduper-filament-starter-kit)[tomatophp/filament-cms

Full CMS System with support of importing integrations and multi meta functions

12112.8k4](/packages/tomatophp-filament-cms)[bpocallaghan/laravel-admin-starter

The Laravel Framework.

3491.4k](/packages/bpocallaghan-laravel-admin-starter)

PHPackages © 2026

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