---

name: storage description: File storage - uploads, CDN, blobs. Use when handling files.

Storage Guideline

Tech Stack

• Storage: Vercel Blob
• Platform: Vercel

Non-Negotiables

• Uploads must be intent-based and server-verified (no direct client uploads to permanent storage)
• Server must validate blob ownership before attaching to resources
• Abandoned uploads must be cleanable

Context

File uploads are a common attack vector. Users upload things you don't expect. Files live longer than you plan. Storage costs accumulate quietly. A well-designed upload system is secure, efficient, and maintainable.

Consider: what could a malicious user upload? What happens to files when the referencing entity is deleted? How does storage cost scale with usage?

Driving Questions

• What could a malicious user do through the upload flow?
• What happens to orphaned files when entities are deleted?
• How much are we spending on storage, and is it efficient?
• What file types do we accept, and should we?
• How do we handle upload failures gracefully?
• What content validation exists (type, size, safety)?