cloudflare-worker-base

SKILL.md

Production-ready Cloudflare Workers setup with Hono, Vite, and Static Assets preventing 10 documented issues.

Prevents critical routing conflicts (API routes returning index.html), export syntax errors, HMR race conditions, and Vite 8+ compatibility issues through tested configuration patterns

Includes auto-provisioning for R2, D1, and KV resources (Wrangler 4.45+), Workers RPC for service-to-service calls, and gradual rollout asset mismatch handling

Covers free tier 429 errors with run_worker_first, cache corruption troubleshooting, and community workarounds for vite-tsconfig-paths and uuid package conflicts

Provides 5-minute quick start, complete wrangler.jsonc/vite.config.ts templates, and one-command deploy pipeline with pre-flight validation

Cloudflare Worker Base Stack

Production-tested: cloudflare-worker-base-test (https://cloudflare-worker-base-test.webfonts.workers.dev)
Last Updated: 2026-01-20
Status: Production Ready ✅
Latest Versions: hono@4.11.3, @cloudflare/vite-plugin@1.17.1, vite@7.3.1, wrangler@4.54.0
Skill Version: 3.1.0

Recent Updates (2025-2026):

Wrangler 4.55+: Auto-config for frameworks (wrangler deploy --x-autoconfig)

Wrangler 4.45+: Auto-provisioning for R2, D1, KV bindings (enabled by default)

Workers RPC: JavaScript-native RPC via WorkerEntrypoint class for service bindings

March 2025: Wrangler v4 release (minimal breaking changes, v3 supported until Q1 2027)

June 2025: Native Integrations removed from dashboard (CLI-based approach with wrangler secrets)

2025 Platform: Workers VPC Services, Durable Objects Data Studio, 64 env vars (5KB each), unlimited Cron Triggers per Worker, WebSocket 32 MiB messages, node:fs/Web File System APIs

2025 Static Assets: Gradual rollout asset mismatch issue, free tier 429 errors with run_worker_first, Vite plugin auto-detection

Hono 4.11.x: Enhanced TypeScript RPC type inference, cloneRawRequest utility, JWT aud validation, auth middleware improvements