Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/jamdesk/jamdesk-cli/llms.txt

Use this file to discover all available pages before exploring further.

By default, Jamdesk hosted docs live on a *.jamdesk.app subdomain. If you want your docs to appear at a subpath of your own domain — such as yoursite.com/docsjamdesk deploy-proxy generates and deploys a Cloudflare Worker that transparently proxies requests from your domain to your Jamdesk site, with no changes required to your docs content or build pipeline.

Subcommand

Currently, deploy-proxy supports one target platform:
SubcommandDescription
cloudflareGenerate and deploy a Cloudflare Worker for subpath hosting
Support for additional platforms may be added in future releases.

Interactive Usage

Running the command without flags launches a step-by-step wizard:
jamdesk deploy-proxy cloudflare
The wizard guides you through:
  1. Wrangler setup — checks for an existing wrangler installation or prompts to install it
  2. Cloudflare authentication — opens the Cloudflare dashboard for OAuth, or uses an existing API token
  3. Account selection — if your Cloudflare login has access to multiple accounts, you choose which one to use
  4. Zone selection — pick the domain zone where the Worker will be routed
  5. Worker generation — writes the Worker files to your output directory
The default subpath is /docs.

Non-Interactive (CI) Usage

Pass flags to skip all prompts and run headlessly — useful in CI pipelines or scripted environments:
jamdesk deploy-proxy cloudflare --slug acme --domain example.com --path /docs --yes

Flags

OptionDescription
--slug <slug>Project slug, skips auto-detection from docs.json
--domain <domain>Target domain to route (e.g., yoursite.com)
--path <path>Subpath prefix to serve docs under (default: /docs)
--output-dir <dir>Directory to write generated files into (default: cloudflare-worker/)
--skip-deployGenerate Worker files only — do not deploy to Cloudflare
--forceOverwrite the output directory if it already exists
--yesSkip all interactive prompts (CI mode)
--verbosePrint detailed output during generation and deployment

Generated Files

After the command runs, the output directory (default: cloudflare-worker/) contains the following files:
FileDescription
index.jsThe Cloudflare Worker script that proxies requests to your Jamdesk site
wrangler.tomlWrangler configuration file with your account ID, zone, and route settings
package.jsonDeclares the wrangler dev dependency for the Worker project
.gitignoreExcludes node_modules and other generated artifacts from version control

Manual Deploy

If you used --skip-deploy or want to redeploy the Worker later without running the full wizard, use wrangler directly from the output directory:
npx wrangler deploy

Further Reading

For a full walkthrough of DNS configuration, route patterns, and troubleshooting, see the Cloudflare deployment guide.

Build docs developers (and LLMs) love