convex-file-storage

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

2|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/metaloozee/geoveda --skill convex-file-storage-metaloozee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/metaloozee/geoveda/tree/main/.cursor/skills/convex-file-storage
Command: npx skills add https://github.com/metaloozee/geoveda --skill convex-file-storage-metaloozee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive solution for managing files within Convex applications, from initial uploads to serving and deletion.

Core Features & Use Cases

  • File Uploads: Handles the complete upload flow, including generating secure upload URLs and client-side handling.
  • File Serving: Generates URLs to serve files directly, supporting various file types like images and PDFs.
  • Data Management: Stores file metadata in Convex tables and allows for deletion of both metadata and storage files.
  • Use Case: Enable users to upload profile pictures, store generated reports, or serve documents directly from your Convex application.

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

File uploads in Convex are handled by generating a secure upload URL through a mutation, performing the client-side upload directly to storage, and then storing the resulting file metadata in a database table.

What is the best way to serve files like images and PDFs directly from Convex storage?

Serving files from Convex storage involves retrieving the storage ID from your database table and generating a dedicated URL to provide direct access to the stored file for client-side rendering.

Can I store file metadata in database tables when using Convex cloud storage?

Yes, you can store file references and metadata in Convex database tables by saving the returned storage ID alongside your application data during the file upload lifecycle.

How do I delete files and their metadata from Convex storage?

Deleting files in Convex requires removing the physical file from cloud storage using its storage ID and simultaneously deleting the corresponding file reference record from your database table.

Does the Convex file storage lifecycle support client-side uploads?

Yes, the Convex file storage lifecycle supports client-side uploads by generating a secure, temporary upload URL on the server that the client can use to upload files directly to cloud storage.