convex-file-storage

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

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/pratikpakhale/convex-next-starter --skill convex-file-storage-pratikpakhale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/pratikpakhale/convex-next-starter/tree/main/.agent/skills/convex/modules/convex-file-storage
Command: npx skills add https://github.com/pratikpakhale/convex-next-starter --skill convex-file-storage-pratikpakhale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the entire process of handling files within Convex applications, from uploading and serving to storing generated content and managing metadata.

Core Features & Use Cases

  • File Uploads: Securely upload any file type with client-side previews and validation.
  • File Serving: Automatically generate URLs to serve files directly.
  • Generated Content Storage: Store files produced by Convex actions (e.g., PDFs, images).
  • Metadata Management: Access and manage file metadata via Convex's system tables.
  • Use Case: An e-commerce platform can use this Skill to allow users to upload product images, store them, and serve them directly on product pages, while also storing generated invoices for orders.

Quick Start

Upload the file 'report.pdf' using the convex-file-storage skill.

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?

Handling file uploads in a Convex application involves generating secure upload URLs, saving the resulting file references to the database, and retrieving file metadata. This supports various file types including images and documents.

Can I store generated files like PDFs directly from Convex actions?

You can store generated files like PDFs directly from Convex actions. The mechanism handles storage of files produced during actions and saves their references to the database for later retrieval.

What is the best way to manage file metadata in Convex?

Managing file metadata in Convex is done by accessing and manipulating the system tables. This allows you to retrieve file references and metadata for uploaded or generated content like images and documents.

Does Convex support serving uploaded files directly via URLs?

Convex supports serving uploaded files directly by automatically generating URLs. Once a file is uploaded and its reference is saved to the database, these URLs provide direct access to the stored content.

How do I delete stored files and their metadata in Convex?

Deleting stored files in Convex requires using the provided deletion capabilities to remove the content. This process manages the removal of the file and its associated metadata from the database.