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

Configurez Cloudflare Workers avec le routage Hono, le plugin Vite et Static Assets à l'aide de modèles testés en production. Empêche 6 erreurs : syntaxe d'exportation, conflits de routage, plantages HMR et confusion du format Service Worker. À utiliser lors de : la création de projets Workers, la configuration de Hono ou Vite for Workers, le déploiement avec Wrangler, ajout d'actifs statiques avec solution de secours SPA, ou dépannage de la syntaxe d'exportation, conflits de routes API, planification les gestionnaires ou les conditions de course HMR. Mots-clés : Cloudflare Workers, CF Workers, Hono, wrangler, Vite, Static Assets, @cloudflare/vite-plugin, wrangler.jsonc, module ES, run_worker_first, repli SPA, routes API, sans serveur, edge computing, "Impossible de lire les propriétés non définies", "Actifs statiques 404", "Une promesse suspendue a été annulée", "Le gestionnaire n'exporte pas", le déploiement échoue, le routage ne fonctionne pas, HMR plante Source : ovachiever/droid-tings.

Voir l'original