File Storage

Upload and serve files through a unified API. The storage adapter is selected by STORAGE_PROVIDER.

Providers

Upload API

POST /api/upload accepts multipart form data. Authentication is required.

const form = new FormData();
form.append('file', file);

const res = await fetch('/api/upload', {
  method: 'POST',
  body: form,
});

const { url } = await res.json();

Image uploads are automatically optimized (resized, compressed) before storage.

Switching to S3 or R2

1. Install the AWS SDK:

pnpm add @aws-sdk/client-s3 @aws-sdk/s3-request-presigner

2. Set the provider and credentials in .env.local:

STORAGE_PROVIDER="s3"   # or "r2"

S3_BUCKET="my-bucket"
S3_REGION="us-east-1"   # use "auto" for R2
S3_ENDPOINT=""           # required for R2 (e.g. https://<account>.r2.cloudflarestorage.com)
S3_ACCESS_KEY_ID="..."
S3_SECRET_ACCESS_KEY="..."
S3_PUBLIC_URL=""         # optional — public URL prefix for uploaded files

Production: Always use S3 or R2. The local adapter stores files on disk and is not suitable for multi-instance deployments.

Programmatic Usage

import { uploadFile, deleteFile } from '@/lib/storage';

const url = await uploadFile('avatars/user-123.webp', buffer, 'image/webp');
await deleteFile('avatars/user-123.webp');

Environment Variables

* Required when STORAGE_PROVIDER=s3 or r2. ** Required for Cloudflare R2 and other S3-compatible providers.