Almacenamiento (Cloudflare R2)

Motoko Base usa Cloudflare R2 para almacenamiento de archivos. R2 es compatible con S3 — la app usa el AWS SDK con un endpoint personalizado.

Official docs: Cloudflare R2 documentation

Setup

1. Crea un bucket R2 en el Cloudflare dashboard → R2
2. Crea un R2 API token (Object Read & Write)
3. Define las env vars:

Sin las env vars de R2 la app arranca — el demo de Storage muestra un mensaje de configuración.

How uploads work

Client → Server Action (presigned PUT URL)
   ↓
Browser uploads directly to R2
   ↓
Server validates (HEAD) → marks file ready in Postgres

Los archivos nunca se proxifican a través de Next.js. El servidor emite una URL firmada; el navegador sube a R2. Los metadatos (nombre, tamaño, propietario) viven en la tabla files.

Límites de upload y MIME types permitidos: src/features/storage/config.ts.

S3-compatible API

Cliente R2: src/lib/r2.ts — usa @aws-sdk/client-s3 con:

• Endpoint: https://{R2_ACCOUNT_ID}.r2.cloudflarestorage.com
• Region: auto
• Path-style URLs (forcePathStyle: true)

Las URLs firmadas PUT (upload) y GET (download) caducan tras 10–15 minutos.

Production

• Usa un bucket privado — acceso solo vía URLs firmadas
• Define las credenciales como env vars solo de servidor (nunca NEXT_PUBLIC_*)
• Los avatares (Settings) también usan R2 cuando está configurado — mismas credenciales
• Considera reglas de lifecycle en Cloudflare para objetos antiguos — no incluidas en el starter

Para CORS: si fallan los uploads del navegador, añade el origen de tu app a la política CORS del bucket en Cloudflare. Consulta R2 CORS docs.

Where to change this

Importa @/lib/r2 solo desde código de servidor — nunca desde client components.

Environment Variables — todas las env vars de R2.