@edgeone/react-router

@edgeone/react-router

EdgeOne adapter plugin for React Router - Automatically converts React Router build output to EdgeOne deployment format with zero configuration.

Features

• ✅ Automatic Asset Migration - Copies build/client to .edgeone/assets
• ✅ Server Bundling - Bundles server code into a single file (SSR mode)
• ✅ Route Metadata Generation - Generates meta.json configuration
• ✅ Multi-Mode Support - CSR, SSR, and Hybrid (SSR + Prerender)
• ✅ Tree-Shaking - Removes unused code automatically
• ✅ Zero External Dependencies - Bundled file requires only Node.js built-ins

Installation

npm install @edgeone/react-router --save-dev

Quick Start

Add the plugin to vite.config.ts:

import { reactRouter } from "@react-router/dev/vite";
import { edgeoneAdapter } from "@edgeone/react-router";
import { defineConfig } from "vite";

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

Build your project:

npm run build

Output structure:

.edgeone/
├── assets/              # Static assets
├── server-handler/      # Server code (SSR only)
│   └── index.mjs       # Single-file server
└── meta.json           # Route metadata

Rendering Modes

CSR (Client-Side Rendering)

Configure in react-router.config.ts:

export default { ssr: false } satisfies Config;

Deploy to any static hosting:

npx serve .edgeone/assets

SSR (Server-Side Rendering)

Configure in react-router.config.ts:

export default { ssr: true } satisfies Config;

Run locally:

node .edgeone/server-handler/index.mjs
# Server at http://localhost:9000

Hybrid (SSR + Prerender)

export default {
  ssr: true,
  async prerender() {
    return ["/", "/about"];
  },
} satisfies Config;

Deployment

EdgeOne Platform

edgeone pages deploy

Learn more about EdgeOne CLI.

Build Process

The adapter uses esbuild to bundle the server with the following optimizations:

• Platform: Node.js 18+
• Format: ESM
• Tree-shaking: Enabled
• External: Node.js built-in modules only
• Bundle size: ~1.88 MB (includes React, React Router, and all dependencies)

Requirements

• Node.js >= 18.0.0
• Vite >= 5.0.0
• React Router >= 7.0.0

License

MIT