nimbus/laravel

Nimbus - Distributed SSR and CRUD for Laravel

v0.1.1 2025-10-20 14:01 UTC

Requires

• php: ^8.2
• firebase/php-jwt: ^6.10
• guzzlehttp/guzzle: ^7.8
• illuminate/http: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0

MIT

README

Complete Inertia.js replacement with distributed SSR, federated CRUD, and JWT auth.

Installation

composer require nimbus/laravel
php artisan nimbus:install
php artisan nimbus:jwt-generate

Usage

1. Configure Providers (config/nimbus.php)

'providers' => [
    'B' => [
        'url' => 'https://b.test',
        'jwks_url' => 'https://b.test/.well-known/nimbus-jwks.json',
    ],
],

2. Render Remote Components

// In Controller
use Nimbus\Laravel\Facades\Nimbus;

public function index() {
    return Nimbus::render('B::Customers/List', [
        'filters' => request('filters'),
    ]);
}

3. CRUD Operations

// Create
$result = Nimbus::store('B::customers', [
    'name' => 'New Customer',
    'email' => '[e-mail]',
]);

// Update
$result = Nimbus::update('B::customers', $id, $data);

// Delete
$result = Nimbus::destroy('B::customers', $id);

4. Routes (routes/web.php)

use Nimbus\Laravel\Facades\Nimbus;

Route::get('/customers', fn() => Nimbus::render('B::Customers/List'));
Route::post('/customers', fn() => Nimbus::store('B::customers', request()->all()));

Provider Setup (App B)

// routes/nimbus.php
Route::nimbusComponent('Customers/List', [CustomerController::class, 'index']);
Route::nimbusResource('customers', CustomerController::class);

Features

✅ Distributed SSR (stream, snapshot, CSR)

✅ Federated CRUD with validation

✅ JWT auth with scopes

✅ Cache with SWR

✅ Vue + React + Svelte support

✅ Drop-in Inertia replacement