33 lines
727 B
Markdown
33 lines
727 B
Markdown
# Avatar CDN Config Notes
|
|
|
|
This project serves avatars from the avatar CDN domain.
|
|
|
|
## Required env variables
|
|
|
|
- `AVATAR_CDN_URL=https://files.skinbase.org`
|
|
- `AVATAR_DISK=s3` (production)
|
|
- `AVATAR_WEBP_QUALITY=85`
|
|
|
|
## Delivery format
|
|
|
|
Avatars are rendered via:
|
|
|
|
- `https://files.skinbase.org/avatars/{user_id}/{size}.webp?v={avatar_hash}`
|
|
|
|
Sizes generated server-side:
|
|
|
|
- `32`, `64`, `128`, `256`, `512`
|
|
|
|
## Cache policy
|
|
|
|
Storage writes must set:
|
|
|
|
- `Cache-Control: public, max-age=31536000, immutable`
|
|
|
|
Hash-based query versioning (`?v={avatar_hash}`) handles cache busting.
|
|
|
|
## Production rule
|
|
|
|
- Production avatar storage must use object storage (`s3` / R2-compatible disk).
|
|
- Local/public disks are for development only.
|