cloudflare-worker-base

SKILL.md

Production-tested: cloudflare-worker-base-test (https://cloudflare-worker-base-test.webfonts.workers.dev) Last Updated: 2025-10-20 Status: Production Ready ✅

Issue #1: Export Syntax Error Error: "Cannot read properties of undefined (reading 'map')" Source: honojs/hono #3955 Prevention: Use export default app (NOT { fetch: app.fetch })

Issue #2: Static Assets Routing Conflicts Error: API routes return index.html instead of JSON Source: workers-sdk #8879 Prevention: Add "runworkerfirst": ["/api/"] to wrangler.jsonc

Produktionserprobtes Setup für Cloudflare Workers mit Hono, Vite und Static Assets. Verwendung bei: Erstellen neuer Cloudflare Workers-Projekte, Einrichten von Hono-Routing mit Workers, Konfigurieren des Vite-Plugins für Workers, Hinzufügen statischer Assets zu Workers, Bereitstellen mit Wrangler, oder es kommt zu Bereitstellungsfehlern, Routing-Konflikten oder HMR-Abstürzen. Verhindert 6 dokumentierte Probleme: Exportsyntaxfehler, Routingkonflikte bei statischen Assets, geplante Handler-Fehler, HMR-Race-Bedingungen, Upload-Race-Bedingungen und Service Worker Formatverwirrung. Schlüsselwörter: Cloudflare Workers, CF Workers, Hono, Wrangler, Vite, Static Assets, @cloudflare/vite-plugin, wrangler.jsonc, ES-Modul, run_worker_first, SPA-Fallback, API-Routen, serverlos, Edge-Computing, „Eigenschaften von undefiniert können nicht gelesen werden“, „Statische Assets 404“, „Ein hängendes Versprechen wurde abgebrochen“, „Handler exportiert nicht“, Bereitstellung schlägt fehl, Routing funktioniert nicht, HMR stürzt ab Quelle: jackspace/claudeskillz.

Original anzeigen