{ "$schema": "https://ui.shadcn.com/schema/registry-item.json", "name": "cloudflare-r2", "type": "registry:block", "title": "Cloudflare R2", "description": "R2 object storage adapter example for uploads and private object reads.", "dependencies": [], "devDependencies": [ "wrangler" ], "registryDependencies": [ "https://stackfoundry.dev/r/file-uploads.json" ], "files": [ { "path": "cloudflare/r2/storage.ts", "type": "registry:file", "target": "cloudflare/r2/storage.ts", "content": "export interface Env {\n FILES: R2Bucket;\n}\n\nexport async function putObject(env: Env, key: string, body: ReadableStream | ArrayBuffer | string) {\n await env.FILES.put(key, body);\n return { key };\n}\n\nexport async function getObject(env: Env, key: string) {\n const object = await env.FILES.get(key);\n if (!object) return new Response(\"Not found\", { status: 404 });\n return new Response(object.body, { headers: object.httpMetadata });\n}\n" }, { "path": "apps/web/src/app/(console)/admin/cloudflare/r2/page.tsx", "type": "registry:page", "target": "apps/web/src/app/(console)/admin/cloudflare/r2/page.tsx", "content": "const checks = [\n \"Install provider package and configure env\",\n \"Run the local example path\",\n \"Add auth, retries, and audit events before production\",\n];\n\nexport default function CloudflareR2Page() {\n return (\n
\n
\n

Cloudflare R2

\n

Object storage adapter for files, exports, and generated assets.

\n
\n
\n {checks.map((check) => (\n
{check}
\n ))}\n
\n
\n );\n}\n" } ], "maintenanceSkills": [ { "name": "cloudflare-r2", "target": ".stackfoundry/skills/cloudflare-r2/SKILL.md", "content": "---\nname: cloudflare-r2\ndescription: Maintain the Cloudflare R2 provider adapter module installed by StackFoundry.\n---\n\n# Cloudflare R2 Skill\n\n## Boundary\n\nThis block owns the Cloudflare R2 integration example only. Keep product-specific business logic outside the provider adapter until the app has chosen this provider.\n\n## Shared Skills\n\nWhen provider, framework, or database behavior changes, load the installed shared skill before editing implementation details:\n\n- `.stackfoundry/skills/cloudflare/SKILL.md` (source: `registry/skills/cloudflare/SKILL.md`)\n- `.stackfoundry/skills/nextjs/SKILL.md` (source: `registry/skills/nextjs/SKILL.md`)\n\nKeep this module skill focused on ownership, installed files, env vars, deployment checks, and module-specific invariants.\n\n## Source Files\n\n- `cloudflare/r2/storage.ts`\n- `apps/web/src/app/(console)/admin/cloudflare/r2/page.tsx`\n\n## Dependencies\n\n- `wrangler (dev)`\n\n## Environment\n\n- No provider env vars declared.\n\n## Deployment Checks\n\n- Create the provider project/resource before deploying.\n- Add env vars to preview and production environments.\n- Run the included smoke route, task, worker, or helper after deploy.\n- Confirm logs do not include secrets, tokens, raw webhook payloads, or customer data.\n\n## Maintenance Rules\n\n- Keep SDK imports and examples aligned with current provider docs.\n- Keep secrets server-only and out of client components.\n- Update `module.json`, `docs.md`, and `tests/checklist.md` together when dependencies, env vars, or files change.\n- Prefer small provider adapters over coupling shared domain modules to one provider.\n" }, { "name": "cloudflare", "target": ".stackfoundry/skills/cloudflare/SKILL.md", "content": "---\nname: cloudflare\ndescription: Cloudflare platform guidance for installed Workers, storage, and edge modules.\n---\n\n# Cloudflare Guidance\n\n## Installed Location\n\n- Installed target: `.stackfoundry/skills/cloudflare/SKILL.md`\n- Registry source: `registry/skills/cloudflare/SKILL.md`\n\nAgents maintaining an installed module should load this shared skill from the installed target when provider, framework, database, SDK, or platform behavior is involved. Keep provider-specific API details here instead of duplicating them inside module maintenance skills.\n\n- Keep bindings explicit in config and docs.\n- Do not commit wrangler secrets or account credentials.\n- Document local dev, preview, and production deployment commands.\n- Verify bindings, routes, and logs after deploy.\n" }, { "name": "nextjs", "target": ".stackfoundry/skills/nextjs/SKILL.md", "content": "---\nname: nextjs\ndescription: Maintain Next.js App Router code installed by StackFoundry modules.\n---\n\n# Next.js Operating Instructions\n\n## Installed Location\n\n- Installed target: `.stackfoundry/skills/nextjs/SKILL.md`\n- Registry source: `registry/skills/nextjs/SKILL.md`\n\nAgents maintaining an installed module should load this shared skill from the installed target when provider, framework, database, SDK, or platform behavior is involved. Keep provider-specific API details here instead of duplicating them inside module maintenance skills.\n\n- Keep server-only data access out of Client Components.\n- Put route handlers under `app/api` and UI routes under the relevant App Router segment.\n- Prefer Server Components for data loading and add `\"use client\"` only for interactivity.\n- Keep public environment variables prefixed with `NEXT_PUBLIC_`; keep secrets server-only.\n- Re-run typecheck and build after changing route handlers, layouts, or shared app configuration.\n" } ], "envVars": {}, "docs": "# Cloudflare R2 Module\n\nR2 object storage adapter example for uploads and private object reads.\n\n## Official Docs\n\n- [Cloudflare R2 Docs](https://developers.cloudflare.com/r2/)\n\n## Owns\n\n- `cloudflare/r2/storage.ts`\n- `apps/web/src/app/(console)/admin/cloudflare/r2/page.tsx`\n\n## Dependencies\n\nNo package dependencies.\n\n## Environment\n\nNo environment variables are required by default.\n\n## Maintenance\n\n- Keep this module focused on the provider adapter boundary.\n- Keep secrets in environment variables and never commit local credentials.\n- Verify the example route or worker path before promoting this module beyond experimental.\n- Update docs, checklist, and manifest metadata when provider APIs change.\n", "meta": { "category": "storage", "env": [], "status": "ready", "maturity": "ready", "recommendedFor": [] } }