# Admin Overview

The Admin package provides the Filament panel surface for Capell CMS.

<span class="theme-aware-image">
  <img class="theme-aware-image__light" src="images/screenshots/admin-dashboard.png" alt="Capell admin dashboard" loading="lazy" />
  <img class="theme-aware-image__dark" src="images/screenshots/admin-dashboard-dark.png" alt="Capell admin dashboard" loading="lazy" />
</span>

## Responsibilities

- Register admin resources, pages, dashboard widgets, and policies.
- Provide extension points for resources, tools, events, settings schemas, and dashboard widgets.
- Coordinate editorial workflows for pages, sites, media, users, themes, and package state.

## Extension Points

- [Admin Multi-Language](admin-multi-language.md): configure admin UI language records, translation files, and per-user language preferences.
- [Admin Tool Registry](admin-tool-registry.md): add admin header tools.
- [Dashboard Widget Customization](dashboard-widget-customization.md): add or override dashboard widgets.
- [Event Registry](event-registry.md): subscribe to admin lifecycle events.
- [User Resource Customization](user-resource-customization.md): add user form fields, sidebar panels, relation managers, and package bridges.
- [Resource Registration](resource-registration.md): register resources and look up contributed admin surfaces.
- [Settings Schema Registry](settings-schema-registry.md): expose package settings in the admin settings surface.
- [Presentation and interactions](presentation-and-interactions.md): reuse the shared widget/block delivery and interaction controls.
- [User Menu Registry](user-menu-registry.md): add user menu items.
- [Schema Hooks](schemas/hooks.md): extend admin forms, tabs, relation managers, page/site/user tables, header actions, publish panels, and export modals.

## Core Editorial Surfaces

The **Pages** resource is the main entry point for creating, nesting, previewing, and publishing site pages.

<span class="theme-aware-image">
  <img class="theme-aware-image__light" src="images/screenshots/admin-pages-list.png" alt="Capell pages list" loading="lazy" />
  <img class="theme-aware-image__dark" src="images/screenshots/admin-pages-list-dark.png" alt="Capell pages list" loading="lazy" />
</span>

The **Media** resource keeps uploaded assets, metadata, and image-management actions close to editorial work.

<span class="theme-aware-image">
  <img class="theme-aware-image__light" src="images/screenshots/admin-media-list.png" alt="Capell media library" loading="lazy" />
  <img class="theme-aware-image__dark" src="images/screenshots/admin-media-list-dark.png" alt="Capell media library" loading="lazy" />
</span>

## Operational Surfaces

**Site Health** lives under System navigation and gives operators one read-only place to check whether public traffic can be served safely before launch or after deployments. It combines cache status, public-output safety, static generation, optimizer readiness, and server checks so issues that can affect public traffic are visible without editing site content.

<span class="theme-aware-image">
  <img class="theme-aware-image__light" src="images/screenshots/site-health-page.png" alt="Capell Site Health page" loading="lazy" />
  <img class="theme-aware-image__dark" src="images/screenshots/site-health-page-dark.png" alt="Capell Site Health page" loading="lazy" />
</span>

## Editorial Workflow Docs

| Page                                                    | Covers                                           |
| ------------------------------------------------------- | ------------------------------------------------ |
| [Permissions and approval](permissions-and-approval.md) | Role and approval rules around admin publishing. |

Publishing approvals, draft workspaces, and scheduled workflows are owned by `capell-app/publishing-studio`; use that package's docs for the full editorial state machine.