davila7__claude-code-templates/cloudflare-workers/README.md

Cloudflare Workers

This directory contains Cloudflare Workers for automation and monitoring tasks that run on Cloudflare's edge network.

Why Cloudflare Workers?

We separate monitoring and automation tasks into Cloudflare Workers to:

• ✅ Separation of concerns: Vercel focuses on the web app, Cloudflare on automated tasks
• ✅ Better performance: Ultra-fast edge computing with 0 cold starts
• ✅ Free cron jobs: Unlimited unlike Vercel
• ✅ Scalability: 100k requests/day on free tier
• ✅ KV Storage included: Save state without a database
• ✅ 100% CLI managed: No dashboard needed - everything via wrangler CLI

📦 Available Workers

docs-monitor

Claude Code documentation monitor with Telegram notifications.

Functionality:

• Monitors https://code.claude.com/docs every 6 hours
• Detects changes using SHA-256 hash
• Sends Telegram notifications when changes occur
• Includes HTTP endpoint for manual triggers

Quick Start (CLI only):

cd docs-monitor
npm install
wrangler login
npm run deploy

Full documentation: docs-monitor/README.md

pulse

Weekly KPI report sent via Telegram every Sunday at 14:00 UTC.

Functionality:

• Collects metrics from GitHub, Discord, Supabase, Vercel
• Formats a consolidated weekly report
• Sends to Telegram automatically via cron
• Manual trigger via HTTP endpoint

Quick Start (CLI only):

cd pulse
npm install
wrangler login
npm run deploy

Full documentation: pulse/README.md

🚀 General Setup (CLI)

Prerequisites

1. Cloudflare account (free)
2. Wrangler CLI installed:

   npm install -g wrangler
   

Common CLI Commands

# Authenticate
wrangler login

# Develop locally
wrangler dev

# Deploy to production
wrangler deploy

# View real-time logs
wrangler tail

# List deployments
wrangler deployments list

# View deployment details
wrangler deployments view <deployment-id>

# List workers
wrangler deployments list

# Delete a worker
wrangler delete

KV Storage Commands (CLI)

# Create KV namespace
wrangler kv:namespace create MY_KV

# List all namespaces
wrangler kv:namespace list

# List keys in namespace
wrangler kv:key list --namespace-id=<id>

# Get key value
wrangler kv:key get <key> --namespace-id=<id>

# Set key value
wrangler kv:key put <key> "<value>" --namespace-id=<id>

# Delete key
wrangler kv:key delete <key> --namespace-id=<id>

Secrets Management (CLI)

# Set a secret
wrangler secret put SECRET_NAME

# List all secrets
wrangler secret list

# Delete a secret
wrangler secret delete SECRET_NAME

📁 Project Structure

Each worker follows this structure:

worker-name/
├── index.js          # Main worker code
├── wrangler.toml     # Cloudflare configuration
├── package.json      # Dependencies and scripts
├── .env.example      # Environment variables template
├── .gitignore        # Git ignored files
└── README.md         # Specific documentation

🔐 Secrets Management

Secrets are stored securely in Cloudflare via CLI:

# Add a secret (prompts for value)
wrangler secret put SECRET_NAME

# List configured secrets (doesn't show values)
wrangler secret list

# Delete a secret
wrangler secret delete SECRET_NAME

⚠️ IMPORTANT: Never commit secrets to code or .env files. Always use wrangler secret put for production.

💰 Costs

Cloudflare Workers free tier includes:

• 100,000 requests/day
• 10ms CPU time/request
• Unlimited cron triggers
• KV: 100k reads/day, 1k writes/day
• 1 GB storage

For most use cases: $0.00/month

📚 Resources

• Cloudflare Workers Documentation
• Wrangler CLI Reference
• Workers Examples
• Cloudflare KV Storage
• Cron Triggers Guide

🤝 Contributing

To add a new worker:

1. Create a directory: cloudflare-workers/my-worker/
2. Follow the standard structure (see above)
3. Document clearly its purpose in README.md
4. Add an entry in this main README
5. Use CLI for all operations

🎯 CLI-First Philosophy

This project emphasizes CLI usage:

• ✅ No need to access Cloudflare Dashboard
• ✅ Everything scriptable and automatable
• ✅ Version control friendly (wrangler.toml)
• ✅ CI/CD ready
• ✅ Reproducible deployments

All worker management, deployment, monitoring, and debugging can be done via wrangler CLI.

---

Part of the claude-code-templates project