cloudflare-worker-base

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

إعداد تم اختباره على الإنتاج لعمال Cloudflare الذين لديهم أصول Hono وVite وStatic. يُستخدم عندما: إنشاء مشاريع Cloudflare Workers جديدة، وإعداد توجيه Hono مع Workers، تكوين البرنامج المساعد Vite للعمال، وإضافة الأصول الثابتة إلى العمال، والنشر باستخدام Wrangler، أو مواجهة أخطاء النشر، أو تعارضات التوجيه، أو تعطل HMR. يمنع 6 مشكلات موثقة: أخطاء في بناء جملة التصدير، وتعارضات توجيه الأصول الثابتة، أخطاء المعالج المجدولة، وظروف سباق HMR، وظروف سباق التحميل، وعامل الخدمة ارتباك التنسيق. الكلمات الرئيسية: عمال Cloudflare، عمال CF، Hono، wrangler، Vite، الأصول الثابتة، @cloudflare/vite-plugin، wrangler.jsonc، وحدة ES، run_worker_first، احتياطي SPA، مسارات واجهة برمجة التطبيقات، بدون خادم، حوسبة الحافة، "لا يمكن قراءة خصائص غير محددة"، "الأصول الثابتة 404"، "تم إلغاء الوعد المعلق"، "لا يقوم المعالج بالتصدير"، فشل النشر، التوجيه لا يعمل، تعطل HMR المصدر: jackspace/claudeskillz.