yacosta738/yacosta738.github.io / .agents/skills/cloudflare
cloudflare
FlaggedComprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), 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/kv/configuration.md
View on GitHub# KV Configuration
## Create Namespace
```bash
wrangler kv namespace create MY_NAMESPACE
# Output: { binding = "MY_NAMESPACE", id = "abc123..." }
wrangler kv namespace create MY_NAMESPACE --preview # For local dev
```
## Workers Binding
**wrangler.jsonc:**
```jsonc
{
"kv_namespaces": [
{
"binding": "MY_KV",
"id": "abc123xyz789"
},
// Optional: Different namespace for preview/development
{
"binding": "MY_KV",
"preview_id": "preview-abc123"
}
]
}
```
## TypeScript Types
**env.d.ts:**
```typescript
interface Env {
MY_KV: KVNamespace;
SESSIONS: KVNamespace;
CACHE: KVNamespace;
}
```
**worker.ts:**
```typescript
export default {
async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
// env.MY_KV is now typed as KVNamespace
const value = await env.MY_KV.get("key");
return new Response(value || "Not found");
}
} satisfies ExportedHandler<Env>;
```
**Type-safe JSON operations:**
```typescript
interface UserProfile {
name: string;
email: string;
role: "admin" | "user";
}
const profile = await env.USERS.get<UserProfile>("user:123", "json");
// profile: UserProfile | null (type-safe!)
if (profile) {
console.log(profile.name); // TypeScript knows this is a string
}
```
## CLI Operations
```bash
# Put
wrangler kv key put --binding=MY_KV "key" "value"
wrangler kv key put --binding=MY_KV "key" --path=./file.json --ttl=3600
# Get
wrangler kv key get --binding=MY_KV "key"
# Delete
wrangler kv key delete --binding=MY_KV "key"
# List
wrangler kv key list --binding=MY_KV --prefix="user:"
# Bulk operations (max 10,000 keys per file)
wrangler kv bulk put data.json --binding=MY_KV
wrangler kv bulk get keys.json --binding=MY_KV
wrangler kv bulk delete keys.json --binding=MY_KV --force
```
## Local Development
```bash
wrangler dev # Local KV (isolated)
wrangler dev --remote # Remote KV (production)
# Or in wrangler.jsonc:
# "kv_namespaces": [{ "binding": "MY_KV", "id": "...", "remote": true }]
```
## REST API
### Single Operations
```typescript
import Cloudflare from 'cloudflare';
const client = new Cloudflare({
apiEmail: process.env.CLOUDFLARE_EMAIL,
apiKey: process.env.CLOUDFLARE_API_KEY
});
// Single key operations
await client.kv.namespaces.values.update(namespaceId, 'key', {
account_id: accountId,
value: 'value',
expiration_ttl: 3600
});
```
### Bulk Operations
```typescript
// Bulk update (up to 10,000 keys, max 100MB total)
await client.kv.namespaces.bulkUpdate(namespaceId, {
account_id: accountId,
body: [
{ key: "key1", value: "value1", expiration_ttl: 3600 },
{ key: "key2", value: "value2", metadata: { version: 1 } },
{ key: "key3", value: "value3" }
]
});
// Bulk get (up to 100 keys)
const results = await client.kv.namespaces.bulkGet(namespaceId, {
account_id: accountId,
keys: ["key1", "key2", "key3"]
});
// Bulk delete (up to 10,000 keys)
await client.kv.namespaces.bulkDelete(namespaceId, {
account_id: accountId,
keys: ["key1", "key2", "key3"]
});
```
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: 472k | 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: 472k | 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: 472k | 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 |