README

A Server-Driven UI (SDUI) framework for Laravel + Inertia.js + React + shadcn/ui.

┌───────────┐    UI Schema (JSON)     ┌───────────┐
│  Laravel  │ ──────────────────────► │   React   │
│   (PHP)   │     "render this"       │  (client) │
└───────────┘                         └───────────┘

RocketPHP sends widget definitions, table schemas, form configurations, and page blocks from PHP. The React layer is stateless — it renders whatever it receives. One source of truth, no duplicated validation, no client-side API surface to design.

→ Read the docs

Requirements

• PHP 8.2+
• Laravel 11 / 12 / 13
• Inertia.js v3 (inertiajs/inertia-laravel)
• Tailwind CSS v4 in the host app
• React 19 + @inertiajs/react
• shadcn/ui components

Install

composer require maherelgamil/rocketphp

Then wire up Tailwind and Vite — see the Installation guide.

Quick look

php artisan rocket:make-panel Admin
php artisan rocket:make-resource User

use App\Models\User;
use MaherElGamil\Rocket\Resources\Resource;
use MaherElGamil\Rocket\Tables\Columns\TextColumn;
use MaherElGamil\Rocket\Tables\Table;

final class UserResource extends Resource
{
    protected static string $model = User::class;

    public static function table(Table $table): Table
    {
        return $table
            ->columns([
                TextColumn::make('id')->sortable(),
                TextColumn::make('name')->sortable(),
                TextColumn::make('email')->sortable()->copyable(),
            ])
            ->searchable(['name', 'email']);
    }
}

Visit /admin/users — you get a sortable, searchable, paginated table, policy-gated and ready to extend. Add a form() to unlock create/edit. Full walkthrough: Quick Start.

Features

• Resources — auto-generated list, create, edit, view pages
• Tables — columns, filters, row + bulk actions, pagination, search
• Forms — 12 field types, layout grouping (Section / Tabs), server-side validation
• Widgets — stats, charts, tables, recent records, activity feeds
• Relation managers — manage related records inline on edit/view
• Custom pages — drop a class in Pages/, it's auto-discovered
• Authorization — policy-gated at every level (nav, page, action)
• Global search — Cmd+K across resources
• Notifications — bell in the header, backed by Notification::send()
• Theming — primary/accent color, font, radius, density per panel
• i18n + RTL — locale switcher, JSON translations, automatic RTL
• Panel auth — opt-in self-contained login, registration, password reset, email verification, and profile pages per panel
• Import / export — Filament-style CSV importers and exporters, queued via batched jobs

Full reference in docs/.

Docs

Testing

git clone https://github.com/maherelgamil/rocketphp.git
cd rocketphp
composer install
./vendor/bin/pest

Contributing

PRs welcome — see the contributing guide.

License

MIT © Maher El Gamil