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.