Avatars

When file uploads are enabled, Account UI provides avatar upload functionality.

Enabling

In quickback.config.ts:

account: {
  fileUploads: true,
  // ...
}

The compiler emits VITE_ENABLE_FILE_UPLOADS=true into the Account SPA's build env. For standalone Account UI deployments (built outside the compiler), set VITE_ENABLE_FILE_UPLOADS=true in .env directly.

Upload Flow

1. User clicks their profile picture
2. Image picker opens (supports JPG, PNG, WebP)
3. Image is cropped to square
4. Uploaded to R2/S3 storage
5. Profile updated with new avatar URL

Requirements

• account.fileUploads: true (or VITE_ENABLE_FILE_UPLOADS=true for standalone)
• R2 bucket or S3-compatible storage configured
• Upload endpoints available in your API

Related

• R2 Storage — File storage setup
• Environment Variables