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.

Arkhe Main Laravel Package

adhocrat-io/arkhe-main

Bootstrap a Laravel admin backend with Livewire 4 + Flux UI: users, roles & permissions (Spatie), user profiles, SEO + sitemap, and cookie-consent. Interactive installer publishes config/migrations, seeds default roles, and patches sidebar/Tailwind scanning.

View on GitHub

Deep Wiki

Context7

3.2.1

Documentation

Clarify in the ArkheNav guide that a menu can only controls link visibility — package routes must still be protected by middleware independently. The menu gate and the route guard are two separate layers.

3.2.0

Added

Shared navigation registry (Arkhe\Main\Support\ArkheNav, with NavSection / NavItem). The backend sidebar is now driven by named sections so satellite packages can branch onto the same menu — add an entry to the shared settings ("Réglages") section, or declare their own collapsible section — without patching any Blade file. Arkhè seeds two default sections: access ("Accès": users, roles, permissions) and settings ("Réglages": SEO, sitemap, cookies). Example:
```
use Arkhe\Main\Support\ArkheNav;

ArkheNav::section('settings')->item(
    key: 'billing', label: fn () => __('billing::nav.title'),
    icon: 'credit-card', route: 'billing.settings', can: 'manage-billing',
);
```
arkhe::arkhe.settings.title translation ("Réglages" / "Settings") for the consolidated settings section heading.

Changed

arkhe::partials.sidebar-items now renders from the registry instead of a hardcoded item list. The default menu is unchanged; the [@include](https://github.com/include) host apps already have keeps working as-is. Roles/permissions/settings visibility is now gated by the root_permission (matching the route guards) rather than the root role, so a custom role granted manage-roles sees those items too.

3.1.0

Added

whitecube/laravel-cookie-consent (^1.3) integration for GDPR cookie consent. Arkhe\Main\Cookies\ArkheCookiesServiceProvider pre-registers Laravel's session + CSRF cookies under "essentials", and the layout renders [@cookieconsentscripts](https://github.com/cookieconsentscripts) / [@cookieconsentview](https://github.com/cookieconsentview) automatically when Features::hasCookieConsent() is true (now the default). Root-only read-only audit page at /administration/cookies (Livewire alias arkhe.cookies, route arkhe.cookies.index) lists every registered category/cookie. New permission view-cookies.
spatie/laravel-sitemap (^8.1) integration. Arkhe\Main\Services\SitemapService wraps SitemapGenerator with config-driven URL/path; a scheduled Arkhe\Main\Jobs\GenerateSitemap job runs daily at the cron expression set by arkhe.sitemap.schedule (defaults 0 3 * * *); the root-only Livewire page at /administration/sitemap exposes a "Regenerate now" button that dispatches the same job onto the host app's queue. Last generation timestamp persisted on the arkhe_site_seo table via a new sitemap_generated_at column. Three new permissions (manage-sitemap, view-sitemap, update-sitemap).
ralphjsmit/laravel-seo (^1.8) is now a first-class dependency. The package's seo() helper is rendered in the Arkhe layout's <head> so every backend page emits sensible meta tags out of the box. See the new SEO section in the README.
Arkhe\Main\Concerns\HasArkheSeo trait — composes HasSEO behind an Arkhe-namespaced alias so consumers add per-record SEO with a single use statement.
Site-wide SEO admin UI at /administration/seo (Livewire alias arkhe.site-seo, route arkhe.site-seo.edit). Edits arkhe_site_seo (a singleton table holding site_name, title_suffix, description, image, author, robots, twitter_username, favicon). A SEOManager::SEODataTransformer registered in the service provider merges these defaults into every SEOData rendered through the layout. Root-only; gated by the new manage-site-seo, view-site-seo, update-site-seo permissions.
arkhe:main:install now offers to publish ralphjsmit/laravel-seo's migration + config when the seo table is missing.
arkhe:main:install now offers to patch the consumer's Tailwind v4 resources/css/app.css with the [@source](https://github.com/source) directive needed to scan the package's Blade views. Idempotent. Falls back to a printed snippet for Tailwind v3 setups (tailwind.config.js).

Changed

Features::hasSeo() and Features::hasCookieConsent() now default to true. Both became first-class features in 3.1.0; the flags remain as escape hatches for consumers that want to disable an integration without removing the dependency.
arkhe:main:install now patches the HasBackendProfile trait into the consumer's App\Models\User before prompting for the root user's credentials, and no longer requires a second run to finish creating the user. The model file is resolved via Composer's ClassLoader instead of Reflection so the class isn't autoloaded ahead of the patch.
list-users, list-roles and list-permissions Livewire pages now use the <flux:table> primitives. Their CSS ships with flux.css (already imported by every consumer), so they render correctly in dark mode even if the consumer's Tailwind build doesn't [@source](https://github.com/source) the vendor path.

Removed

The unused arkhe.install.patch_restart translation key.

3.0.0

V3 is a from-scratch rewrite that keeps the V2 public surface (namespace, provider name, config prefixes) so existing host apps upgrade in place — no search-replace of use Arkhe\Main\… statements required. The major bump covers the bumped Spatie dependency (^7), the new permission-based RBAC, the Livewire 4 page rewrites, and the lifecycle-hook extensibility layer.

Added

arkhe:main:upgrade-from-v2 Artisan command — appends missing V3 keys (dashboard_route, role_permissions, components, backend_permission, root_permission, features…) to the host app's config/arkhe.php without disturbing V2 entries, and rewrites legacy Livewire aliases (arkhe.main.livewire.admin.users.users-list → arkhe.list-users) inside resources/views/. Supports --dry-run.
Permission-based RBAC: 16 default permissions seeded by ArkheRolesSeeder, mapped to roles via config('arkhe.role_permissions') (use the literal '*' to grant every permission, typical for root).
EnsureUserIsRoot middleware (alias arkhe.root) gating the sensitive zone (roles + permissions management) on the configurable arkhe.root_permission (defaults to manage-roles).
arkhe.backend middleware now also accepts a role-list fallback through config('arkhe.admin.roles') — V2-shaped configs without seeded permissions keep working.
Livewire pages are rebindable via config('arkhe.components'). Override any of list-users, list-roles, list-permissions, dashboard with a host-app subclass; routes auto-resolve to the configured class.
Lifecycle hooks (beforeSave, afterCreate, afterUpdate, beforeDelete) on every Livewire CRUD page — for side-effects that need UI context (form state, flash messages) rather than a global event.
RoleHierarchy support helper — derives the role hierarchy from the order of config('arkhe.roles') so renaming/inserting a role updates the seeder AND the assignment rules in one place.
ListRoles + ListPermissions Livewire CRUD pages, restricted to the root area.
Dashboard opt-in route registered when ARKHE_DASHBOARD_ROUTE is set, with optional Fortify home redirect override (ARKHE_OVERRIDE_FORTIFY_REDIRECT).
arkhe:main:add-user CLI command for non-interactive user provisioning.
Install command auto-patches the host app's sidebar with Arkhe links.
tests/Feature/ExtensibilityTest.php, PermissionSeederTest.php, ProfileMigrationSkipTest.php, UpgradeFromV2CommandTest.php — extending coverage to ~78% of src/.

Changed

BREAKING (build-time, not source-level) — spatie/laravel-permission constraint bumped from ^6.25 to ^7.0. Host apps should run composer update spatie/laravel-permission --with-all-dependencies during the V3 upgrade.
add_arkhe_profile_columns_to_users_table migration is now idempotent column-by-column (Schema::getColumnListing + add only the missing ones, with a symmetric down()). Apps that already had first_name, last_name, date_of_birth, civility from V2 migrate cleanly.
ArkheRolesSeeder is non-destructive — re-running it does not strip permissions the host app has granted to its own roles.
Default layout switched from arkhe::layouts.app to layouts::app so the Livewire starter kit's sidebar wraps Arkhe pages out of the box. Set ARKHE_ADMIN_LAYOUT=arkhe::layouts.app to fall back to the package's minimal header-only layout.

Compatibility

Namespace Arkhe\Main\ preserved — all use Arkhe\Main\… imports in host apps continue to resolve.
Provider Arkhe\Main\ArkheMainServiceProvider preserved — composer's package discovery picks the V3 provider with no changes to host app composer.json extra.laravel.providers.
Config prefixes preserved — V2 entries (admin.prefix, admin.layout, top-level permissions, roles, role_hierarchy, role_labels) keep working unchanged. V3 reads the new keys with V2 fallbacks (arkhe.admin.prefix falls back to arkhe.route_prefix, arkhe.admin.layout falls back to arkhe.layout).

2.0.0

Added

Initial package skeleton based on spatie/laravel-package-tools.
ArkheMainServiceProvider with config, views, translations, route and migration auto-discovery.
Backend mounted at a configurable prefix (default: /administration).
EnsureUserHasBackendAccess middleware aliased as arkhe.backend.
HasBackendProfile trait (wraps Spatie\Permission\Traits\HasRoles) exposing full_name, avatar_url, initials and the helpers isArkheRoot() / isArkheAdmin().
UserRepository + UserRepositoryInterface contract.
UserService for mutations (create/update/delete) with avatar upload, role and permission sync, dispatching UserCreated / UserUpdated / UserDeleted events.
Livewire ListUsers full-page component with Flux UI Free (search, sort, filters, pagination, modal CRUD with avatar upload).
arkhe:main:install interactive command (publishes config + migrations, seeds the four default roles, creates a root user).
French translations (default) with English fallback.
Features::hasCookieConsent() / Features::hasSeo() flags for phase 2.
Pest 4 test suite covering install command, ListUsers CRUD/auth/search/sort, and HasBackendProfile.
GitHub Actions matrix: PHP 8.3/8.4 × Laravel 12/13 × prefer-lowest/prefer-stable, with an optional dev-master job.

Weaver

How can I help you explore Laravel packages today?

Conversation history is not saved when not logged in.

Add packages to context

No packages found.

codraw/framework-extra-bundle

codraw/messenger

codraw/security

codraw/mailer

codraw/contracts

codraw/profiling

codraw/dependency-injection

codraw/tester

codraw/core

nexmo/api-specification

capell-app/block-library

axium/identity

cetria/laravel-dummy-models

cetria/reflection-helper

agropredict/sso-auth-bundle

evolvestudio/spam-protection

datacore/hub-sdk

develia/commons

cuci/prototurk-sdk

cuci/prototurk-sdk-symfony