cf-starter-gotchas

Document common pitfalls when forking the Cloudflare Multi-Worker Starter Kit.

10|Updated May 22, 2025
One-click install
npx skills add https://github.com/firtoz/cf-multiworker-starter-kit --skill cf-starter-gotchas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cf-starter-gotchas
Source: https://github.com/firtoz/cf-multiworker-starter-kit/tree/main/agents/skills/cf-starter-gotchas
Command: npx skills add https://github.com/firtoz/cf-multiworker-starter-kit --skill cf-starter-gotchas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The cf-starter-gotchas Skill captures and communicates the common pitfalls encountered when forking and maintaining the Cloudflare Multi-Worker Starter Kit, helping teams avoid misconfigurations and brittle setups.

Core Features & Use Cases

  • Comprehensive checklist covering env imports, route exports, type generation, generated artifacts, and DO/DB integration.
  • Guidance for avoiding regressions when evolving the starter kit across apps/web and durable-objects.
  • Use case examples illustrating how to align implementations with the starter kit conventions to reduce onboarding time.

Quick Start

Follow the cf-starter-gotchas guide when forking or modifying the starter kit to avoid common pitfalls.

Frequently Asked Questions about cf-starter-gotchas

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why are my Cloudflare Workers routing exports not working after forking the starter kit?

Routing exports break when forking the starter kit due to misconfigured route configurations. This Skill documents common routing gotchas and required frontmatter fields to ensure safe, reproducible multi-worker setups.

How do I fix env imports and typegen issues in a Cloudflare Multi-Worker setup?

Fix Cloudflare Multi-Worker env imports and typegen issues by aligning with starter kit conventions. This Skill provides a comprehensive checklist covering generated artifacts, type generation, and env imports to avoid brittle setups.

What are common Cloudflare Durable Objects pitfalls when adding new packages?

Common Cloudflare Durable Objects pitfalls when adding new packages include integration regressions and misconfigurations. This Skill identifies gotchas specific to evolving durable-objects and DO/DB integration to maintain safe setups.

Does this guide cover Cloudflare D1 database integration and Turbo HMR gotchas?

Yes, this guide covers Cloudflare D1 database integration and Turbo HMR gotchas. It captures common pitfalls encountered when maintaining the starter kit, helping teams avoid misconfigurations across apps/web and durable-objects.

What Cloudflare starter kit forms and frontmatter configurations are required?

Required Cloudflare starter kit configurations include specific frontmatter fields and optional resource directories. This Skill defines guardrails and required frontmatter to ensure safe, reproducible setups when modifying the kit.