Storage Providers
Bloomx abstracts file storage using an S3-compatible interface. This allows you to bring your own bucket from almost any cloud provider.
How Uploads Work
- Client Request: The Composer requests a pre-signed URL from
/api/upload/presign. - Server Validation: We check file size limits (25MB) and mime types.
- Direct Upload: The browser uploads the file directly to the bucket using the pre-signed URL.
- Reference: Only the final URL is stored in the email body.
Compatible Providers
AWS S3
The standard. Robust, reliable, but can be expensive for high egress.
Cloudflare R2
Recommended. Zero egress fees make it perfect for email attachments.
MinIO
Self-hosted compatible server. Great for local development or on-premise.