convex-file-storage

Handle file uploads, storage, serving, and management in Convex applications with proper patterns for images, documents, and generated files. Before implementing, do not assume; fetch the latest documentation: Convex provides built-in file storage with: - Primary: - Upload Files: - Serve Files: - For broader context: - Automatic URL generation for serving files - Support for any file type (images, PDFs, videos, etc.) - File metadata via the _storage system table - Integration with mutations and actions - Never run npx convex deploy unless explicitly instructed - Never run any git commands unless explicitly instructed - Validate file types and sizes on the client before uploading - Store file metadata (name, type, size) in your own table - Use the _storage system table only for Convex metadata - Delete storage files when deleting database references - Use appropriate Content-Type headers when uploading - Consider image optimization for large images - Not setting Content-Type header - Files may not serve correctly - Forgetting to delete storage - Orphaned files waste storage - Not validating file types - Security risk for malicious uploads - Large file uploads without progress - Poor UX for users - Using deprecated getMetadata - Use ctx.db.system.get instead - Convex Documentation: - Convex LLMs.txt: - File Storage: - Upload Files: - Serve Files: