Stockage (Cloudflare R2)

Motoko Base utilise Cloudflare R2 pour le stockage de fichiers. R2 est compatible S3 — l'app utilise le AWS SDK avec un endpoint personnalisé.

Official docs: Cloudflare R2 documentation

Setup

1. Créez un bucket R2 dans le Cloudflare dashboard → R2
2. Créez un R2 API token (Object Read & Write)
3. Définissez les variables d'environnement :

Sans les variables R2, l'app démarre — le demo Storage affiche un message de configuration.

How uploads work

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

Les fichiers ne sont jamais proxyifiés via Next.js. Le serveur émet une URL présignée ; le navigateur upload vers R2. Les métadonnées (nom, taille, propriétaire) vivent dans la table files.

Limites d'upload et MIME types autorisés : src/features/storage/config.ts.

S3-compatible API

Client R2 : src/lib/r2.ts — utilise @aws-sdk/client-s3 avec :

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

Les URLs présignées PUT (upload) et GET (download) expirent après 10–15 minutes.

Production

• Utilisez un bucket privé — accès uniquement via URLs présignées
• Définissez les credentials comme variables serveur uniquement (jamais NEXT_PUBLIC_*)
• Les avatars (Settings) utilisent aussi R2 lorsqu'il est configuré — mêmes credentials
• Envisagez des règles de lifecycle Cloudflare pour les anciens objets — non livrées dans le starter

Pour CORS : si les uploads navigateur échouent, ajoutez l'origine de votre app à la politique CORS du bucket dans Cloudflare. Voir R2 CORS docs.

Where to change this

Importez @/lib/r2 uniquement depuis le code serveur — jamais depuis des client components.

Environment Variables — toutes les variables R2.