Admin

Capell Admin is the Filament surface for editing and operating Capell sites. It owns the dashboard, pages, sites, languages, layouts, themes, media, users, roles, settings, extension pages, and package-owned admin screens.

Status: Available · Package: capell-app/admin

What To Use

Need	Use
Add the panel to an app	php artisan filament:install --panels, then php artisan capell:admin-setup or php artisan capell:install.
Change /admin	Laravel route/domain config around the Filament panel; keep installer and lockdown access in mind.
Add a package settings screen	SettingsSchemaRegistry::register() and registerSettingsClass().
Add admin resources, pages, widgets, or configurators	AdminBridge plus AdminBridgeRegistrar, or CapellAdmin::contributeToAdminSurface(...) for small direct contributions.
Add page/site/user form fields	Tagged schema extenders such as PageSchemaExtender::TAG, SiteSchemaExtender::TAG, or UserSchemaExtender::TAG.
Add header tools	Tag an AdminToolItem with AdminToolItem::TAG.
Add user menu actions	CapellAdmin::registerUserMenuItem(...).
Add content widgets	CapellAdmin::registerWidget(...) or CapellAdmin::registerDiscoverableWidgets(...).
Add lifecycle callbacks	CapellCore::subscriberManager()->subscribe(...) or AdminEventRegistry.

Core Screens

Screen	Purpose
Dashboard	Health, account/package state, publishing work, recent content, and role-aware widgets.
Pages	Page tree, create/edit flow, page URLs, layout assignment, publishing dates, preview, duplicate, bulk move, export.
Sites and languages	Domains, default site/language state, language records, locale-aware editing.
Layouts and themes	Records that connect page content to frontend presentation.
Media	Uploads, metadata, focal points, localized alt text, crop/preview support through the active media backend.
Settings	Core, Admin, Frontend, package, dashboard, and theme-studio settings.
Extensions	Installed package state, package settings/control pages, Marketplace connection alert when Marketplace is installed.
Site Health	Read-only checks for public traffic readiness.
Recovery	Import/export shell; execution belongs to capell-app/backup when installed.
Lockdown	Emergency frontend lock-down and break-glass admin access.

Read Next

Need	Read
Install or repair the admin panel	Admin setup
Understand the admin domain model	Admin domain
Register package admin surfaces	Admin bridges
Debug missing admin extension surfaces	Debugging admin extensions
Customize dashboard widgets	Dashboard widgets
Work with media records	Media management
Generate theme images from the admin	Generated theme images
Recover from broken admin state	Recovery

Extension Rules

• Keep business rules in Actions. Filament resources, pages, tables, widgets, and Livewire components should delegate.
• Put visible strings in translations, including labels introduced by package extenders.
• Prefer an AdminBridge when a package contributes several surfaces. It keeps package boot code small and central.
• Use AdminSurfaceContributionData for pages, resources, widgets, configurators, schema extenders, and panel extenders.
• Use backed enums implementing HasLabel for option sets; do not bury option arrays in resources.
• Admin-only data must not leak into public frontend output. In-page authoring is a post-load authenticated admin feature, not public HTML.

Common Package Contributions

use Capell\Admin\Contracts\Bridges\AdminBridge;
use Capell\Admin\Data\Bridges\AdminBridgeContextData;
use Capell\Admin\Support\Bridges\AdminBridgeRegistrar;

final class BlogAdminBridge implements AdminBridge
{
    public function register(AdminBridgeRegistrar $registrar, AdminBridgeContextData $context): void
    {
        $registrar->resource(BlogPostResource::class, group: 'content', name: 'blog-posts');
        $registrar->widget(RecentPostsWidget::class);
        $registrar->settingsClass('blog', BlogSettings::class);
        $registrar->settingsSchema('blog', BlogSettingsSchema::class);
    }
}

Register the bridge from the package service provider:

CapellAdmin::registerAdminBridge('capell-app/blog', BlogAdminBridge::class);

Optional Admin Features

Feature	Package
Article resources	capell-app/blog
Visual content sections	capell-app/content-sections
Navigation manager	capell-app/navigation
Publishing approvals and scheduled workflow	capell-app/publishing-studio
Recovery execution	capell-app/backup
AI media tools	capell-app/media-ai

Optional package feature docs live with the package that owns the feature. See Approved packages for the wider package list.