convex-file-storage

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

Updated Dec 25, 2025
One-click install
npx skills add https://github.com/benfwalla/things-to-be-happy-about --skill convex-file-storage-benfwalla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/benfwalla/things-to-be-happy-about/tree/main/.claude/skills/convex-file-storage
Command: npx skills add https://github.com/benfwalla/things-to-be-happy-about --skill convex-file-storage-benfwalla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex File Storage provides a complete approach to handling uploads, storage, serving, and management of files within Convex applications, streamlining workflows for images, documents, and generated assets.

Core Features & Use Cases

  • Upload URLs and client-side upload flows to store files securely
  • Serve files via generated URLs and retrieve file metadata from the _storage system
  • Manage lifecycle including updating, deleting, and referencing generated files in actions and mutations

Quick Start

Upload a file using the generated upload URL, store its metadata, and retrieve a public URL to serve the 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?

To handle file uploads in a Convex application, you generate an upload URL, send the file from the client, and store its metadata using mutations. This approach securely manages images and documents.

How does file storage and URL generation work in Convex?

Convex file storage uses the _storage system to manage files and generate URLs. You retrieve these generated URLs within mutations and actions to securely serve stored assets in your web app.

Can I manage file metadata and lifecycle events with Convex?

Yes, you can manage the file lifecycle in Convex by accessing metadata, updating references, and deleting files. This is done by integrating storage operations directly within your mutations and actions.

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

The best way to serve documents and images in Convex is by generating and retrieving public URLs through the _storage system. This enables secure client-side access to your uploaded assets.

Are there security best practices for managing file uploads in Convex?

Security best practices for Convex file uploads involve generating secure upload URLs and managing file metadata access strictly within validated mutations and actions to prevent unauthorized asset retrieval.