Visit project on GitHub
Set theme to dark

denoflare site

Develop and deploy a static docs site to Cloudflare Pages

How to use

Define your content as Markdown files in a GitHub repo, and quickly generate a static site in the style of Cloudflare's Docs Engine .

It's very similar to the process of creating a Docs Engine site, but with a bit more configuration.

Importantly, you can host the generated output on Cloudflare Pages , instead of Workers Sites .

Take a look at the source of this site as an example.

Deploy to Cloudflare Pages

Use denoflare site generate inside a custom build.

  • In your Pages deployment, use the following settings:

    • Framework preset: None
    • Build Command: ./build.sh
    • Build output directory: /output
  • Create the build.sh file in the root of your content repo, for example:

#!/bin/sh
DENO_VERSION="v1.23.0"
DENOFLARE_VERSION="v0.5.6"
curl -fsSL https://deno.land/x/install/install.sh | DENO_INSTALL=./deno-v1.23.0 sh -s v1.23.0
NO_COLOR=1 DENO_VERSION=v1.23.0 DENOFLARE_VERSION=${DENOFLARE_VERSION} \
    ./deno-v1.23.0/bin/deno run --unstable --allow-all \
    https://raw.githubusercontent.com/skymethod/denoflare/v0.5.6/cli/cli.ts \
    site generate . ./output --verbose

--help

$ denoflare site --help
denoflare-site 0.5.6

Develop and deploy a static docs site to Cloudflare Pages

USAGE:
    denoflare site <subcommand> <args> <options>

SUBCOMMANDS:
    generate   Develop and deploy a static docs site to Cloudflare Pages
    serve      Host a static Cloudflare Pages site in a local Deno web server

For subcommand-specific help: denoflare site <subcommand> --help