convex-file-storage

Manage file uploads, serving, storage, and deletion in Convex applications.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/debsouryadatta/memo-hack --skill convex-file-storage-debsouryadatta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/debsouryadatta/memo-hack/tree/main/.agent/skills/convex-file-storage
Command: npx skills add https://github.com/debsouryadatta/memo-hack --skill convex-file-storage-debsouryadatta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the entire process of managing files within Convex applications, from secure uploads to serving and deletion.

Core Features & Use Cases

  • File Uploads: Handles the complete upload flow, including generating secure upload URLs.
  • File Serving: Provides direct URLs for accessing stored files.
  • Metadata Management: Integrates with Convex's system tables to store and retrieve file metadata.
  • Deletion: Ensures proper cleanup by deleting both storage files and database records.
  • Use Case: A user uploads a profile picture, which is then stored, a URL is generated for display, and its metadata is saved in the user's profile.

Quick Start

Use the convex-file-storage skill to upload a file and save its reference.

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 a Convex application?

File uploads in Convex are handled by generating secure upload URLs on the server, sending the file from the client, and then saving the storage reference in a database mutation. This process supports images and documents.

What is the best way to store and retrieve file metadata using Convex?

Storing and retrieving file metadata in Convex involves saving file references in your database records and querying the Convex `_storage` system table. This integration links the stored file with its corresponding metadata for retrieval.

How do I generate a secure upload URL for cloud storage in Convex?

Generating a secure upload URL for cloud storage in Convex uses a server-side query to produce a temporary endpoint. The client uploads the file directly to this URL, after which a mutation saves the file reference.

Does Convex support deleting files and cleaning up database records?

Yes, Convex supports deleting files by executing a mutation that removes the physical file from the `_storage` system table and its associated metadata record from the database, ensuring proper cleanup.

Can I use this approach to manage user profile picture uploads and display?

Yes, you can manage profile picture uploads by uploading the file, generating a direct URL for display, and saving the metadata in the user's profile. This creates a complete upload and serving workflow.