# Global CDN Delivery

> Edge-first architecture with global object storage and 300+ edge locations. Logos are cached at the edge for sub-100ms delivery worldwide.

## How It Works

1. **Cloudflare Workers** — All logic runs on Cloudflare's edge network, close to the user.
2. **R2 Object Storage** — Logos are stored in Cloudflare R2 with zero egress fees and global replication.
3. **Multi-layer caching** — R2 for persistence, browser Cache-Control headers, and Cloudflare CDN edge caching.
4. **Content-type detection** — Format is detected from the first bytes of the image (SVG, PNG, JPEG, WebP, ICO).

## Benefits

- Sub-100ms delivery from 300+ global edge locations
- Zero egress fees with R2 object storage
- Automatic content-type detection from image bytes
- Serverless Workers — no cold starts, instant scaling
- Long-lived cache headers for browser and CDN caching
- 99.99% uptime with Cloudflare's global infrastructure

## Cache Headers

```
Cache-Control: public, max-age=86400, s-maxage=2592000
X-Logo-Cache: HIT (from R2) | MISS (freshly fetched) | MONOGRAM
```

## Related

- [Domain Logo Lookup](/features/domain-lookup.md)
- [Smart Monogram Fallbacks](/features/monogram-fallbacks.md)
- [Full API Reference](/docs.md)