Storage

ShipFree includes an R2 client built on aws4fetch in src/lib/storage.ts.

Capabilities

Upload base64 strings or remote URLs
Upload blobs and buffers
Generate signed upload and download URLs
Delete objects from public or private buckets

Required environment variables

CLOUDFLARE_ACCOUNT_ID
R2_ACCESS_KEY_ID
R2_SECRET_ACCESS_KEY
R2_BUCKET_URL
R2_PUBLIC_BUCKET
R2_PRIVATE_BUCKET

Usage

import { storage } from '@/lib/storage'

await storage.upload({
  key: 'avatars/user-1.png',
  body: someBlob,
  bucket: 'public',
})

Uploads will fail if bucket configuration is missing. Validate your R2 settings before enabling storage features.

MonitoringSentry integration and runtime hooks.