try-works/role-model / .agents/skills/cloudflare
cloudflare
UnverifiedComprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), feature flags (Flagship), networking (Tunnel, Spectrum), security (WAF, DDoS), and infrastructure-as-code (Terraform, Pulumi). Use for any Cloudflare development task. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.
references/email-workers/configuration.md
View on GitHub# Email Workers Configuration
## wrangler.jsonc
```jsonc
{
"name": "email-worker",
"main": "src/index.ts",
"compatibility_date": "2025-01-27",
"send_email": [
{ "name": "EMAIL" }, // Unrestricted
{ "name": "EMAIL_LOGS", "destination_address": "logs@example.com" }, // Single dest
{ "name": "EMAIL_TEAM", "allowed_destination_addresses": ["a@ex.com", "b@ex.com"] },
{ "name": "EMAIL_NOREPLY", "allowed_sender_addresses": ["noreply@ex.com"] }
],
"kv_namespaces": [{ "binding": "ARCHIVE", "id": "xxx" }],
"r2_buckets": [{ "binding": "ATTACHMENTS", "bucket_name": "email-attachments" }],
"vars": { "WEBHOOK_URL": "https://hooks.example.com" }
}
```
## TypeScript Types
```typescript
interface Env {
EMAIL: SendEmail;
ARCHIVE: KVNamespace;
ATTACHMENTS: R2Bucket;
WEBHOOK_URL: string;
}
export default {
async email(message: ForwardableEmailMessage, env: Env, ctx: ExecutionContext) {}
};
```
## Dependencies
```bash
npm install postal-mime mimetext
npm install -D @cloudflare/workers-types wrangler typescript
```
Use postal-mime v2.x, mimetext v3.x.
## tsconfig.json
```json
{
"compilerOptions": {
"target": "ES2022", "module": "ES2022", "lib": ["ES2022"],
"types": ["@cloudflare/workers-types"],
"moduleResolution": "bundler", "strict": true
}
}
```
## Local Development
```bash
npx wrangler dev
# Test receiving
curl --request POST 'http://localhost:8787/cdn-cgi/handler/email' \
--url-query 'from=sender@example.com' --url-query 'to=recipient@example.com' \
--header 'Content-Type: text/plain' --data-raw 'Subject: Test\n\nHello'
```
Sent emails write to local `.eml` files.
## Deployment Checklist
- [ ] Enable Email Routing in dashboard
- [ ] Verify destination addresses
- [ ] Configure DMARC/SPF/DKIM for sending
- [ ] Create KV/R2 resources if needed
- [ ] Update wrangler.jsonc with production IDs
```bash
npx wrangler deploy
npx wrangler deployments list
```
## Dashboard Setup
1. **Email Routing:** Domain → Email → Enable Email Routing
2. **Verify addresses:** Email → Destination addresses → Add & verify
3. **Bind Worker:** Email → Email Workers → Create route → Select pattern & Worker
4. **DMARC:** Add TXT `_dmarc.domain.com`: `v=DMARC1; p=quarantine;`
## Secrets
```bash
npx wrangler secret put API_KEY
# Access: env.API_KEY
```
## Monitoring
```bash
npx wrangler tail
npx wrangler tail --status error
npx wrangler tail --format json
```
## Troubleshooting
| Error | Fix |
|-------|-----|
| "Binding not found" | Check `send_email` name matches code |
| "Invalid destination" | Verify in Email Routing dashboard |
| Type errors | Install `@cloudflare/workers-types` |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |