README

Turn your Filament panel's homepage into a SAP Fiori-style launchpad: Spaces, Pages, Sections and drag-and-drop KPI/shortcut/widget cards, with role-based visibility and a full builder UI — all rendered inside the native Filament shell.

Screenshots

The launchpad home page in light mode: sub-nav tabs, sections and tile cards.

The same home page in dark mode — panel chrome (topbar, sidebar) stays native.

The layout builder: drag cards from the library or existing sections to rearrange the page.

"Edit Home" in the account/user menu — a one-click shortcut into the builder for the home page.

The "Permission" field on a Space/Page/Section/Card, restricting visibility to selected roles.

Managing Spaces, Pages and Sections through the plugin's Resources.

The flat Cards index, also reachable from Filament's global search.

A native Filament widget (StatsOverviewWidget/ChartWidget) rendered in place of a card.

Features

Fiori-style launchpad home page — sub-nav tabs, grouped sections, and a grid of clickable cards, rendered inside the native Filament page shell (topbar, sidebar, breadcrumbs and dark mode stay untouched).
Space → Page → Section → Card hierarchy — manage everything through dedicated Filament Resources and nested relation managers.
Sub-nav navigation — "☰ All Spaces" menu, a per-space Pages dropdown, and an automatic "More ▾" overflow (priority-nav) so the tab bar never scrolls.
Three card types — KPI (live value from a KpiSource class), Shortcut (link to a Resource, Page or URL), and Widget (renders a native StatsOverviewWidget/ChartWidget in place of the card).
Class-based KPI engine — a KpiSource returns a rich KpiResult (value + unit + trend + badge) from one query; auto-discovered under app/Filament/Launchpad, resolved lazily with per-request memoization and an optional (tenant-safe) cached TTL, and scopeable per panel. Legacy closure sources still supported; a throwing source degrades the tile to —. Never eval'd, never user-controlled.
Artisan generators — make:launchpad-kpi, make:launchpad-widget and make:launchpad-card scaffold KPI/widget/card-preset classes (auto Kpi/Widget/Card suffix, optional --model= subfolder).
Reusable card library — draggable presets for the builder, defined once and dropped into as many sections as needed.
Auto-discovered widget library — widgets already registered on the panel are available in the builder out of the box; override label/icon/column span or add extra ones only when needed.
Drag-and-drop layout builder — native HTML5 Drag and Drop (Alpine-driven, no external JS library), with a searchable Card Library and Widgets panel.
"Edit Home" shortcut — a one-click entry in the account/user menu straight into the builder for the home page, without navigating the Spaces/Pages tree.
Global search — Cards are searchable from Filament's built-in global search, with the Section/Page/Space they live in shown as result details.
Role-based visibility (Fiori-style permissions) — a "Permission" field on every Space/Page/Section/Card, softly integrated with bezhansalleh/filament-shield and spatie/laravel-permission.
Localization — English, European Portuguese, Brazilian Portuguese and generic Portuguese translations included, fully overridable.

Requirements

PHP 8.2+
Filament 5.0+ (4.0+ also supported)
Laravel (Illuminate contracts/support) 11.0+, 12.0+, or 13.0+

Installation

Install the package via Composer:

composer require anselmocossa/filament-launchpad

Run the installer — it publishes the config, then optionally runs the package migrations:

php artisan launchpad:install          # publish config
php artisan launchpad:install --migrate # ...and run the migrations (asks first)

Prefer to do it by hand? The package auto-loads its migrations, so run them normally:

php artisan migrate

Optionally publish the config file, views or translations:

php artisan vendor:publish --tag="launchpad-config"
php artisan vendor:publish --tag="launchpad-views"
php artisan vendor:publish --tag="launchpad-lang"

use Filament\Launchpad\LaunchpadPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(LaunchpadPlugin::make());
}

The plugin registers a Launchpad page at the panel root (/), so it becomes the panel home. If your panel also registers the default Dashboard page, remove it (or give it another slug) so the launchpad can own /.

After installing, build the launchpad from the UI: create a Space, a Page inside it, a Section inside that, and Cards inside the Section — or use the drag-and-drop builder (see below) instead of the plain forms.

Usage

Spaces, Pages, Sections and Cards

The launchpad is database-driven by default. The hierarchy is:

Space — a top-level entry in the sub-nav. A Space with a single Page renders as a plain button; with several Pages it shows a dropdown.
Page — lives inside a Space and holds Sections. Selecting a Page swaps which Sections render.
Section — a titled group of Cards on a Page.
Card — a single tile: KPI, Shortcut, or Widget.

Manage all four through the plugin's Filament Resources (Spaces, reachable from the sidebar; Pages, Sections and Cards reachable through relation managers and the "Pages"/"Cards" header buttons), or build a Page visually with the drag-and-drop builder.

KPI sources

A KPI card's live value comes from a KpiSource class that returns a rich KpiResult (value + unit + trend + badge) from a single query. Scaffold one with artisan:

php artisan make:launchpad-kpi SalesToday
# → app/Filament/Launchpad/SalesTodayKpi.php   ("Kpi" suffix added automatically)

php artisan make:launchpad-kpi SalesToday --model=Order
# → app/Filament/Launchpad/Order/SalesTodayKpi.php

namespace App\Filament\Launchpad;

use App\Models\Order;
use Filament\Launchpad\Launchpad\BaseKpiSource;
use Filament\Launchpad\Launchpad\KpiResult;

class SalesTodayKpi extends BaseKpiSource
{
    public function cacheFor(): ?int
    {
        return 120; // seconds; null = no TTL cache (still memoized once per request)
    }

    public function resolve(): KpiResult
    {
        return KpiResult::make(Order::whereDate('created_at', today())->count())
            ->unit('orders')
            ->trend('+3 today', 'success') // success | danger | gray
            ->badge('new');                // pass null to hide the badge
    }
}

BaseKpiSource derives key() (sales_today) and label() (Sales Today) from the class name (the Kpi suffix is stripped). A KPI Card references the source by its key() from the "Source (Live)" select in the Card form; a source that throws degrades the tile to — instead of breaking the page. A Card without a source can still use a "Fixed Value" typed into the form.

Registration. Drop the class under app/Filament/Launchpad and it is auto-discovered — no wiring needed. Register explicitly (which turns auto-discovery off) or scan a custom folder instead:

use Filament\Launchpad\LaunchpadPlugin;

LaunchpadPlugin::make()
    ->kpis([\App\Filament\Launchpad\SalesTodayKpi::class])          // explicit
    ->discoverKpis(in: app_path('Metrics'), for: 'App\\Metrics')    // custom folder
    ->autoDiscoverKpis(false);                                      // opt out entirely

The legacy closure form still works for quick one-offs and is fully backward-compatible:

LaunchpadPlugin::make()->kpiSources([
    'open_tickets' => fn () => Ticket::whereNull('resolved_at')->count(),
]);

Per-panel scoping. Override panels() to limit a source to specific panels (empty = all):

public function panels(): array
{
    return ['store'];
}

Multi-tenant caching. When cacheFor() is set, values are cached under the source's cacheKey() (defaults to key()). In a multi-tenant app, override it so a cached value never leaks across tenants:

public function cacheKey(): string
{
    return static::key().':'.tenancy()->tenant()?->id;
}

Card library

Card Library presets show up in the builder's "Card Library" panel, ready to be dragged into any Section. Define each as a CardPreset class (auto-discovered under app/Filament/Launchpad) — scaffold one with artisan:

php artisan make:launchpad-card SalesToday
# → app/Filament/Launchpad/SalesTodayCard.php   ("Card" suffix added automatically)

namespace App\Filament\Launchpad;

use Filament\Launchpad\Launchpad\BaseCardPreset;

class SalesTodayCard extends BaseCardPreset
{
    protected string $title = 'Sales Today';

    protected ?string $subtitle = 'Point of Sale';

    protected ?string $icon = 'heroicon-o-banknotes';

    protected string $type = 'kpi';                  // kpi | shortcut | widget

    protected string $targetType = 'url';            // none | url | resource | page

    protected ?string $targetValue = '/admin/sales';

    // protected ?string $kpiSource = 'sales_today'; // optionally pre-wire a live KPI source
}

BaseCardPreset derives the key() from the class name (SalesTodayCard → sales_today). Registration mirrors KPI sources: auto-discovered by default, or register explicitly / scan a custom folder / opt out with ->cards([...]), ->discoverCards(in:, for:), ->autoDiscoverCards(false).

The legacy array form still works and is merged with the class-based presets (class presets win on key collision):

LaunchpadPlugin::make()->cardLibrary([
    ['key' => 'sales-today', 'title' => 'Sales Today', 'type' => 'kpi', 'target_type' => 'url', 'target_value' => '/admin/sales'],
]);

Presets are reusable — dropping the same preset into several Sections is expected; wire a kpi_source (or edit the value) on the created Card afterwards.

Widgets

Any widget already registered on the panel through widgets() or discoverWidgets() is automatically available in the builder's "Widgets" library. Use widgets() on the plugin only to override the generated label/icon/column span, or to expose a widget that is not registered on the panel:

use App\Filament\Widgets\RevenueChart;
use Filament\Launchpad\LaunchpadPlugin;

LaunchpadPlugin::make()->widgets([
    [
        'key' => 'revenue-chart',
        'class' => RevenueChart::class,
        'label' => 'Revenue',
        'icon' => 'heroicon-o-chart-bar',
        'columnSpan' => 'full',
    ],
]);

Dropping a widget from the library creates a Card of type widget that stores only its registered key — the class is resolved from the developer's registration at render time, never read from the database directly.

Scaffold a launchpad-ready widget (a StatsOverviewWidget, no custom view required) with artisan:

php artisan make:launchpad-widget Revenue            # → app/Filament/Launchpad/RevenueWidget.php
php artisan make:launchpad-widget Revenue --model=Order  # → app/Filament/Launchpad/Order/RevenueWidget.php

Drag-and-drop builder

Open the builder from a Page's Build action (Spaces → a Space → Pages → a Page), or jump straight to the home page's builder via Edit Home in the account/user menu. From there you can:

Add, rename, reorder and delete Sections.
Drag a preset from the Card Library, or a widget from the Widgets panel, into any Section.
Drag existing Cards between Sections, or reorder them within a Section.
Click a Card to edit it in place (same form used by the Cards relation manager).

Global search

Cards are registered as globally searchable (by title and subtitle) through Filament's built-in global search. A result shows which Section/Page/Space the Card lives in, and navigates to whatever the Card's target resolves to.

Configuration

The published config file (config/launchpad.php) exposes branding, accent_color, dark_header, and tile_sizing:

return [
    'branding' => [
        'name' => 'Launchpad',
        'logo' => null,
    ],
    'accent_color' => '#16a34a',
    'dark_header' => false,
    'tile_sizing' => 'fluid', // 'fixed' (6 equal columns, 1/6 row width each) or 'fluid' (auto-fit, minmax 176px)
];

fixed: repeat(6, 1fr) — always 6 equal columns, each card exactly 1/6 of row width, no empty space, no stretching.
fluid: auto-fit minmax(176px, 1fr) — tiles stretch equally to fill the row, more tiles per row on wider screens.

Both modes use auto-fit so empty grid tracks collapse when fewer tiles than columns.

Prefer the fluent plugin API for anything beyond these — LaunchpadPlugin::make()->accentColor('#16a34a')->tileSizing('fixed') — since the config file cannot express closures (live KPIs, widget mappings).

Permissions & Shield

Every Space, Page, Section and Card has a Permission field: the roles allowed to see it. Leave it empty and everyone can see the item — this is the default, unrestricted behaviour, with no dependency required.

Install bezhansalleh/filament-shield (which pulls in spatie/laravel-permission) to turn the field into an active gate:

composer require bezhansalleh/filament-shield spatie/laravel-permission
php artisan shield:install

Once installed:

A Space/Page/Section/Card restricted to one or more roles is hidden from any user who does not hold at least one of them — cascading down the hierarchy (an empty Space, Page or Section, once everything inside it is filtered out, is hidden too).
The Shield super_admin role always sees everything, regardless of restrictions.
The Launchpad (home) and EditHome pages are themselves gated (View:Launchpad, View:EditHome), and the Spaces/Pages/Sections/Cards Resources ship their own policies — Shield's convention-based policy discovery does not reach models under Filament\Launchpad\Models\*, so the plugin registers these policies itself.
A restricted Card is also excluded from Filament's global search results for users without the role.

Without spatie/laravel-permission installed, none of the above applies: the "Permission" field is simply not rendered, and every ability is granted.

Localization

Translation catalogs are included for:

English (en) — base language
Portuguese (pt)
European Portuguese (pt_PT)
Brazilian Portuguese (pt_BR)

Publish and override the translation files with:

php artisan vendor:publish --tag="launchpad-lang"

Then edit resources/lang/vendor/launchpad/{locale}/launchpad.php — every string in the plugin (labels, buttons, builder copy, model names) is wrapped in __('launchpad::launchpad.*'), so any published locale immediately overrides the package default.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Issues and pull requests are welcome. Please run composer lint and composer test before submitting a PR, and keep new strings translatable via launchpad::launchpad.*.

Security Vulnerabilities

If you discover any security-related issues, please email anselmokossa.apk@gmail.com instead of using the issue tracker.

Credits

Anselmo Cossa

License

The MIT License (MIT). Please see License File for more information.

anselmocossa / filament-launchpad

Maintainers

Package info

Statistics

Security