Docusaurus

Start from CLI: Scaffold a Docusaurus project on Workers, and pick your template.

npm

yarn

pnpm

npm create cloudflare@latest -- my-docusaurus-app --framework=docusaurus

yarn create cloudflare my-docusaurus-app --framework=docusaurus

pnpm create cloudflare@latest my-docusaurus-app --framework=docusaurus

Or just deploy: Create a documentation site with Docusaurus and deploy it on Cloudflare Workers, with CI/CD and previews all set up for you.

What is Docusaurus?

Docusaurus is an open-source framework for building, deploying, and maintaining documentation websites. It is built on React and provides an intuitive way to create static websites with a focus on documentation.

Docusaurus is designed to be easy to use and customizable, making it a popular choice for developers and organizations looking to create documentation sites quickly.

Deploy a new Docusaurus project on Workers

Create a new project with the create-cloudflare CLI (C3).
npm
yarn
pnpm
npm create cloudflare@latest -- my-docusaurus-app --framework=docusaurus --platform=workers
yarn create cloudflare my-docusaurus-app --framework=docusaurus --platform=workers
pnpm create cloudflare@latest my-docusaurus-app --framework=docusaurus --platform=workers
Develop locally.

After creating your project, run the following command in your project directory to start a local development server.
npm
yarn
pnpm
npm run dev
yarn run dev
pnpm run dev
Deploy your project.

Your project can be deployed to a *.workers.dev subdomain or a Custom Domain, from your local machine or any CI/CD system, (including Workers Builds).

Use the following command to build and deploy your project. If you're using a CI service, be sure to update your "deploy command" accordingly.
npm
yarn
pnpm
npm run deploy
yarn run deploy
pnpm run deploy

Deploy an existing Docusaurus project on Workers

If you have a static site

If your Docusaurus project is entirely pre-rendered (which it usually is), follow these steps:

Add a Wrangler configuration file.

In your project root, create a Wrangler configuration file with the following content:
wrangler.jsonc
wrangler.toml
{ "name": "my-docusaurus-app", // Update to today's date // Set this to today's date "compatibility_date": "2026-11-02", "assets": { "directory": "./build" } }
name = "my-docusaurus-app" # Set this to today's date compatibility_date = "2026-11-02" [assets] directory = "./build"
Build and deploy your project.

You can deploy your project to a *.workers.dev subdomain or a custom domain from your local machine or any CI/CD system (including Workers Builds). Use the following command to build and deploy. If you're using a CI service, be sure to update your "deploy command" accordingly.
npm
yarn
pnpm
npx docusaurus build
yarn docusaurus build
pnpm docusaurus build
npm
yarn
pnpm
npx wrangler@latest deploy
yarn dlx wrangler@latest deploy
pnpx wrangler@latest deploy

Use bindings with Docusaurus

Bindings are a way to connect your Docusaurus project to other Cloudflare services, enabling you to store and retrieve data within your application.

With bindings, your application can be fully integrated with the Cloudflare Developer Platform, giving you access to compute, storage, AI and more.