convex-file-storage

Manage file upload, storage, serving, and metadata in Convex applications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex File Storage provides end-to-end file management for Convex apps, enabling upload, secure storage, URL serving, and metadata handling without building a custom back end.

Core Features & Use Cases

  • Upload and store files with metadata
  • Serve files via generated URLs for web and mobile
  • Delete and manage generated files, store metadata in system tables
  • Use cases include user avatars, documents, and generated assets

Quick Start

Configure and run a sample upload flow to store and serve an image using the built-in storage APIs.

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?

You can store and serve files in Convex by generating a secure upload URL, sending the file payload to that URL, and saving the resulting storage identifier in your database via a mutation.

What is the best way to serve user avatars and documents stored in Convex?

The best way to serve user avatars and documents is to retrieve the stored file's metadata and generate a serving URL. This provides web and mobile clients direct access to the generated assets without a custom back end.

Can I delete stored files and their metadata using Convex mutations?

Yes, you can delete stored files and their associated metadata using Convex mutations. This removes the physical storage entry and cleans up the system tables tracking the file references.

Does Convex file storage work for managing generated assets without a custom backend?

Yes, Convex file storage manages generated assets without a custom backend by providing built-in storage APIs. It handles upload URLs, secure storage, serving via URL, and metadata access entirely within your Convex application.

What are the limitations of using Convex for file storage?

Limitations of Convex file storage include relying entirely on the platform's built-in storage APIs and system tables for metadata tracking. You must use generated upload URLs and mutations rather than direct file system access or custom backends.