🧃 Juice

Zero-bloat React 19 RSC framework.
Streaming SSR. Server Actions. Zero config.

Install

npm install @cmj/juice react@^19 react-dom@^19 vite@^6

Quickstart

npx @cmj/create-juice-app my-app
cd my-app
npm install
npm run dev

Or scaffold for a specific target:

npx @cmj/create-juice-app my-app --target cloudflare

Targets: bun (default), node, cloudflare, deno

CLI

API

juice/plugin

The Vite plugin. Zero config.

// vite.config.ts
import { defineConfig } from 'vite';
import juice from '@cmj/juice/plugin';

export default defineConfig({
  plugins: [juice()],
});

juice/runtime

The WinterCG-compliant edge runtime.

// server.ts
import { createRouter } from '@cmj/juice/runtime';
import manifest from './dist/flight-manifest.json' with { type: 'json' };

const handler = createRouter(manifest);
// handler: (Request) => Promise<Response>

How It Works

Source (.tsx) → Vite Plugin → flight-manifest.json → Runtime → Response

1. Compile: The Vite plugin detects 'use client' and 'use server' directives, generates proxy modules, and emits a flight-manifest.json.
2. Serve: The runtime reads the manifest and streams RSC responses using React 19's renderToReadableStream.
3. Deploy: The Request → Response signature works on any WinterCG platform.

Features

• React 19 RSC — Server Components, Suspense, streaming SSR
• Server Actions — 'use server' with FormData support
• Zero config — One plugin call, no magic files
• Zero runtime deps — Pure ESM, nothing to install at runtime
• Multi-platform — Bun, Node.js, Cloudflare Workers, Deno
• Empathic errors — "What-Why-How" error messages for fast debugging
• HMR — Full hot module replacement in development

License

MIT