Deploy Fumadocs to Cloudflare Workers with Vinext

Fumadocs is one of the best documentation frameworks in the React ecosystem — built on Next.js with MDX support, full-text search, and a polished UI out of the box. But deploying a Next.js app to Cloudflare has historically been painful. Enter Vinext — Cloudflare's Vite-based reimplementation of the Next.js API surface. It lets you run your Next.js App Router project on Cloudflare Workers without rewriting anything. Sounds simple. In practice, there are a few sharp edges. This guide walks through every step and pitfall we hit deploying a real Fumadocs site to Cloudflare Workers. Prerequisites A working Fumadocs project (App Router) Bun or Node.js installed A Cloudflare account 1. Install Dependencies bun add -d vinext vite @vitejs/plugin-rsc react-server-dom-webpack @cloudflare/vite-plugin wrangler Add "type": "module" to your package.json : { "type" : "module" } 2. Create vite.config.ts Fumadocs uses MDX, which needs to be transformed before the RSC plugin processes it. The key is pla