Introduction - Lunar PHP

Lunar’s admin panel (lunarphp/panel) is the first-party interface store administrators use to manage a Lunar store: catalog, orders, customers, discounts, and settings.

The stack

The panel is built with Inertia.js v3 and Vue 3, styled with Tailwind CSS v4. It ships compiled, production-ready JavaScript assets, so a host application does not need a Node.js build step to run it — assets are published (or symlinked during local development) into the host’s public/ directory. Its defining feature is a runtime extension mechanism: add-on packages register pages, navigation items, table columns, filters, actions, dashboard widgets, and injected page content without the host application or the panel itself recompiling any JavaScript. See Installation to get it running, and Extending the panel for the extension API.

Lunar ships three separate panel-related packages. They coexist, and it is easy to confuse them by name.

Package	What it is	Provider
`lunarphp/panel`	The new admin panel described on this page: Inertia.js + Vue 3, the intended successor going forward.	`Lunar\Panel\PanelServiceProvider`
`lunarphp/admin`	The v1-era admin panel, built on Filament v5. Still fully supported in v2 and coexists with `lunarphp/panel`.	`Lunar\Admin\LunarPanelProvider` (despite the name, this is the Filament panel)
`lunarphp/filament`	Not a panel on its own — a bridge library of reusable Filament v5 components (selectors, actions, widgets, global search) that any Filament panel can install via `LunarPlugin::make()`. Used internally by `lunarphp/admin`.	`Lunar\Filament\LunarFilamentServiceProvider`

See the Filament admin add-on docs for details on the other two packages.

A tour of the panel

Dashboard

A customizable widget grid. Staff can reorder, hide, and re-add widgets; each widget declares its own permission and default visibility.

Global search

A command palette (opened with Cmd+K) that searches across records. It can be backed by Laravel Scout for typo-tolerant matching.

Catalog

Products with variants, options, media, and prices, alongside collections, brands, and product types.

Sales

Orders in a fulfilment-centric view with a refund composer, plus customers and discounts.

Settings

Activity log, attributes, channels, countries, currencies, customer groups, languages, locations, product options, regions, roles, staff, tags, and tax.

Edit drafts

Staff edits are saved as drafts with conflict detection against concurrent changes, rather than writing straight to the live record.

Other panel-wide features include dark mode and 16 UI locales.

Next steps

Installation

Require the package, run the installer, and create a staff account.

Configuration

The full lunar.panel config reference.

Access control

The staff guard, mandatory two-factor authentication, and permissions.

​The stack

​A tour of the panel