AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

cloudflare-deploy

Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.

Original source
openai
License
Apache-2.0
Pinned revision
49f948faa9258a0c61caceaf225e179651397431

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read openai--cloudflare-deploy at revision 49f948faa9258a0c61caceaf225e179651397431, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 309

references/c3/gotchas.md

C3 Troubleshooting

Deployment Issues

Placeholder IDs

Error: "Invalid namespace ID"
Fix: Replace placeholders in wrangler.jsonc with real IDs:

npx wrangler kv namespace create MY_KV  # Get real ID

Authentication

Error: "Not authenticated"
Fix: npx wrangler login or set CLOUDFLARE_API_TOKEN

Name Conflict

Error: "Worker already exists"
Fix: Change name in wrangler.jsonc

Platform Selection

| Need | Platform | |------|----------| | Git integration, branch previews | --platform=pages | | Durable Objects, D1, Queues | Workers (default) |

Wrong platform? Recreate with correct --platform flag.

TypeScript Issues

"Cannot find name 'KVNamespace'"

npm run cf-typegen  # Regenerate types
# Restart TS server in editor

Missing types after config change: Re-run npm run cf-typegen

Package Manager

Multiple lockfiles causing issues:

rm pnpm-lock.yaml  # If using npm
rm package-lock.json  # If using pnpm

CI/CD

CI hangs on prompts:

npm create cloudflare@latest my-app -- \
  --type=hello-world --lang=ts --no-git --no-deploy

Auth in CI:

env:
  CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
  CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

Framework-Specific

| Framework | Issue | Fix | |-----------|-------|-----| | Next.js | create-next-app failed | npm cache clean --force, retry | | Astro | Adapter missing | Install @astrojs/cloudflare | | Remix | Module errors | Update @remix-run/cloudflare* |

Compatibility Date

"Feature X requires compatibility_date >= ..."
Fix: Update compatibility_date in wrangler.jsonc to today's date

Node.js Version

"Node.js version not supported"
Fix: Install Node.js 18+ (nvm install 20)

Quick Reference

| Error | Cause | Fix | |-------|-------|-----| | Invalid namespace ID | Placeholder binding | Create resource, update config | | Not authenticated | No login | npx wrangler login | | Cannot find KVNamespace | Missing types | npm run cf-typegen | | Worker already exists | Name conflict | Change name | | CI hangs | Missing flags | Add --type, --lang, --no-deploy | | Template not found | Bad name | Check cloudflare/templates |