Admin Theme

Über

Dieses Plugin bringt ein Shadcn-basiertes Admin-Theme für Payload CMS, das das Panel ohne Codeänderungen umgestaltet. Die gesamte Konfiguration liegt in einem admin-editierbaren Global (Slug `admin-theme`, Gruppe System). Beim Speichern wird das Panel neu gerendert. Der Vorgang erfordert keinen Neustart, keinen Rebuild und kein Deploy. Das Plugin baut auf dem `payload-theme`-Paket auf, das das Shadcn-Stylesheet, die Icon-Sidebar, die Command Palette und das Login-Layout bereitstellt. Diese Komponenten werden re-exportiert, nicht kopiert. Das Plugin ergänzt eine Konfigurationsschicht: einen serverseitigen CSS-Injektor (`buildCSS`), der bei jedem Request den Global mit 5s Cache neu liest, und Branding-Komponenten für Sidebar und Login-Screen. Über `config.admin.components` ersetzt es den Basis-`ThemeProvider`, den Login-Hero und die Header-Aktionen. Die Datenbank ist damit die Single Source of Truth, nicht ein browserspezifisches `localStorage`. Eine einzige Accent-Hexfarbe steuert das gesamte Panel. Die 50-950-Skala wird in OKLCH berechnet, die Textfarbe auf dem Accent nach WCAG-Kontrast gewählt. Über das Panel lassen sich Accent, Radius (none, sm, md, lg, full), Typografie (Inter, Geist, Helvetica, System, Payload), Presets (Zinc, Ocean, Forest, Sunset, Berry, Swiss), Logo mit dunkler Variante und Favicon, Login-Hintergrund, Overlay, Heading, Tagline, Site-Titel, Content-Breite (centered, full) und die Navigation pro Collection (Lucide-Icon, Gruppe, Sichtbarkeit) anpassen. Dasselbe Menü steuert Sidebar und Dashboard-Karten. Die Paletten-Eingriffe im Header und der Warna & Bentuk Tab bearbeiten beide denselben Global über die REST-API und rufen `router.refresh()` auf, wodurch Änderungen für alle Nutzer sofort sichtbar werden. Zwei Bestandteile bleiben im Code, weil sie bei der Generierung der Import Map aufgelöst werden, nicht pro Request: Lucide-Icons pro Collection und Dashboard-Widgets. Beide werden über `themeOptions` übergeben. Der Light/Dark-Modus ist eine nutzerbezogene Einstellung und wird nicht im Global gespeichert. Die Plugin-Optionen umfassen `defaults`, `globalSlug`, `adminGroup`, `themeOptions`, `installBaseTheme`, `access` (read/update) und `disabled`.

Paketinformationen

Paketname

payload-admin-theme

Neueste Version

1.2.0

Entpackte Größe

508 kB

Lizenz

MIT

Wöchentliche Downloads

20

Zuletzt veröffentlicht

1. Sep. 2026