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 Workers с Hono, Vite и Static Assets. Используйте при: создании новых проектов Cloudflare Workers, настройке маршрутизации Hono с помощью Workers, настройка плагина Vite для Workers, добавление статических активов в Workers, развертывание с помощью Wrangler, или возникновение ошибок развертывания, конфликтов маршрутизации или сбоев HMR. Предотвращает 6 задокументированных проблем: синтаксические ошибки экспорта, конфликты маршрутизации статических ресурсов, запланированные ошибки обработчика, условия гонки HMR, условия гонки загрузки и Service Worker путаница форматов. Ключевые слова: работники Cloudflare, работники CF, Hono, wrangler, Vite, статические активы, @cloudflare/vite-plugin, wrangler.jsonc, модуль ES, run_worker_first, резервный вариант SPA, маршруты API, бессерверные вычисления, периферийные вычисления, «Невозможно прочитать свойства неопределенного объекта», «Статические активы 404», «Висячее обещание было отменено», «Обработчик не экспортирует», развертывание завершается сбоем, маршрутизация не работает, HMR аварийно завершает работу. Источник: jackspace/claudeskillz.