multiworker-gotchas - Avoid Cloudflare multi-worker fork and template pitfalls
Provides conventions and troubleshooting guidance for Cloudflare multi-worker apps, including bindings, generated artifacts, routing, D1, Durable Objects, HMR, and SSR.
Tags
Updated: 2026-09-28Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Check Worker binding imports
- Manage generated database artifacts
- Export typed route paths
- Regenerate and verify types
- Validate form action patterns
- Configure Alchemy and D1
- Troubleshoot stale local state
- Integrate Durable Object packages
- Forward WebSocket upgrades
- Respect SSR browser boundaries
Inputs
- Repository source files
- Worker bindings and environment variables
- Route and schema changes
- Alchemy and deployment configuration
- Durable Object package changes
Outputs
- Implementation guidance
- Generated type artifacts
- Generated migration artifacts
- Typecheck and lint results
- Deployment troubleshooting guidance
Requirements
- Bun toolchain
- Cloudflare Workers project
- Alchemy and D1 configuration
- React Router application stack
- Durable Objects support when applicable