README

A bridge between Laravel and Bun for React Server Components, streaming HTML, PHP callables, and server actions — all over Unix sockets.

Features

• React Server Components — Server-rendered React with zero client JS for server components
• File-based routing — Next.js App Router conventions (pages, layouts, route groups, dynamic segments)
• PHP callables — Call Eloquent, auth, sessions directly from server components via php()
• Server actions — "use server" functions for form mutations
• Streaming HTML — Suspense boundaries stream progressively over the wire
• Partial Prerendering (PPR) — Static shell cached at build time, dynamic content streamed at runtime
• Parallel routes — @folder convention for named layout slots
• Route interception — (.)/(..)/(...) convention for modals on SPA navigation
• Typed routes — Auto-generated type-safe route() helper
• Inertia SSR — Drop-in replacement for Inertia's Node SSR server
• Sub-millisecond IPC — Binary frame protocol over Unix sockets

Quick Start

composer require larabun/lara-bun
bun add react react-dom react-server-dom-webpack

BUN_RSC_ENABLED=true
BUN_BRIDGE_SOCKET=/tmp/my-app-bridge.sock

// resources/js/rsc/app/page.tsx
export default async function Home() {
  const posts = await php<Post[]>('Posts.latest');
  return (
    <main>
      {posts.map(p => <article key={p.id}><h2>{p.title}</h2></article>)}
    </main>
  );
}

php artisan bun:dev

Requirements

• PHP 8.2+ with the sockets extension
• Laravel 11+
• Bun 1.0+
• React 19

Documentation

Full documentation, guides, and live demos at larabun.dev

Performance

~30% faster with zero additional PHP memory overhead. Unix sockets skip the TCP stack entirely.

Support

If this saved you time, consider supporting the project:

License

MIT