Deploy SlideStage Lite to Cloudflare Workers

SlideStage Lite is a static Vite app. Production deployment builds dist/ and publishes it as Cloudflare Workers static assets.

Prerequisites

• Node.js 20 or newer.
• pnpm 10.28 or newer.
• A Cloudflare account.
• The SlideStageLite repository root.

Wrangler is fetched on demand with pnpm dlx; do not add it as a dependency.

1. Install dependencies

pnpm install

2. Optional environment config

Copy .env.example only if you need beian footer chips:

cp .env.example .env

Quote URLs that contain #.

3. Build

pnpm build

The output is dist/.

4. Preview Cloudflare behavior

pnpm preview:cloudflare

Check the landing page, SPA fallback, real static files such as /stage-sw.js, and converter entry points.

5. Deploy

pnpm deploy:cloudflare

For CI, set:

• CLOUDFLARE_API_TOKEN
• CLOUDFLARE_ACCOUNT_ID

Troubleshooting

If subroutes refresh to 404, check wrangler.jsonc and ensure not_found_handling is single-page-application.

If .env changes do not appear, rebuild and redeploy.