convex-file-storage

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

Updated Aug 23, 2026

Search Tags:#images #mutations #storage #convex #uploads #files #file-storage

Ready to run

npx skills add https://github.com/JuanQuenga/piggies-ts --skill convex-file-storage-juanquenga

💬 Prompt for ChatGPT / Claude Chat▼

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.