convex-file-storage

Handle file uploads, serving, storage, deletion, and metadata in Convex applications.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/Sim-hub22/internquest --skill convex-file-storage-sim-hub22
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/Sim-hub22/internquest/tree/main/.agents/skills/convex-file-storage
Command: npx skills add https://github.com/Sim-hub22/internquest --skill convex-file-storage-sim-hub22

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive solution for handling file uploads, serving files via URLs, storing generated files, managing deletions, and accessing file metadata within Convex applications.

Core Features & Use Cases

  • File Uploads: Securely upload any file type, including images and documents.
  • File Serving: Automatically generate URLs to serve files directly.
  • Generated Files: Store files produced by Convex actions.
  • Metadata Access: Retrieve and manage file metadata from system tables.
  • Deletion: Cleanly remove files from storage and database references.
  • Use Case: An e-commerce platform can use this Skill to allow users to upload product images, serve these images on product pages, and store generated thumbnails.

Quick Start

Use the convex-file-storage skill to generate an upload URL for a new file.

Frequently Asked Questions about convex-file-storage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle file uploads in Convex applications?

File uploads in Convex are handled by generating a secure upload URL through a mutation, which allows clients to directly upload any file type, including images and documents, to cloud storage. The Skill manages this complete upload flow seamlessly.

Can I serve files via URL from Convex storage?

Yes, serving files via URL from Convex storage is supported. The Skill automatically generates URLs that allow you to serve stored files directly to your application, making it easy to display uploaded images or provide document downloads for users.

What is the best way to store generated files from Convex actions?

Storing generated files from Convex actions is managed by saving files produced during action execution directly into Convex file storage. This approach integrates with mutations to ensure generated content, like thumbnails, is properly saved and referenced.

How do I access file metadata in Convex system tables?

Accessing file metadata in Convex involves querying the system tables using Convex queries. The Skill enables you to retrieve and manage file metadata, allowing your application to track storage details and database references for uploaded or generated files.

Does Convex file storage support deleting files and cleaning up database references?

Yes, deleting files in Convex storage is fully supported. The Skill ensures that files are cleanly removed from cloud storage and that associated database references are managed, preventing orphaned data when files are deleted through mutations.

What file types are supported for storage and serving in Convex?

Convex file storage supports any file type, including images and documents commonly used on platforms like e-commerce sites. The Skill handles uploading and serving these various file formats while integrating with Convex queries for data management.