convex-file-storage

Store and serve uploaded files with generated URLs in Convex applications.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/EricJamesCrow/smartpockets --skill convex-file-storage-ericjamescrow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/EricJamesCrow/smartpockets/tree/main/.claude/skills/convex-file-storage
Command: npx skills add https://github.com/EricJamesCrow/smartpockets --skill convex-file-storage-ericjamescrow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

File uploads, serving, and metadata management are error-prone and bulky; this skill provides a cohesive pattern for storing files, serving them via generated URLs, and accessing _storage metadata within Convex apps.

Core Features & Use Cases

  • Uploads and stores any file type (images, PDFs, videos) with automatic URL serving
  • Retrieve and inspect file metadata from the _storage system table
  • Delete files and clean up both storage and related references
  • Generate and store produced files (e.g., PDFs or images) and reference them in your DB

Quick Start

Upload a file and obtain a usable URL to serve it, then save a reference in your database.

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 and serve files in a Convex application?

Handling file uploads in Convex requires storing files in the _storage system table and generating URLs to serve them. This skill provides mutations and queries to manage upload URLs, file serving, and metadata access.

How do I retrieve file metadata from the Convex _storage system table?

Retrieving file metadata from the Convex _storage system table involves querying the storage records to inspect asset details. This skill provides query patterns to access and inspect metadata for uploaded files.

Can I generate and store produced files like PDFs directly in Convex?

You can generate and store produced files like PDFs or images in Convex by saving them to the _storage system table. This skill handles generating storage URLs and referencing these produced files within your database.

What is the best way to delete files and clean up storage references in Convex?

Deleting files in Convex requires removing the asset from storage and cleaning up related database references. This skill manages the complete lifecycle, ensuring both storage deletion and reference cleanup are handled properly.

Does this file storage pattern work for any file type uploaded to Convex?

This file storage pattern supports uploading and serving any file type, including images, PDFs, and videos. It automatically generates URLs for serving these assets and manages their metadata within the Convex _storage system table.

Why do my generated file URLs fail to serve assets correctly in Convex?

Generated file URLs in Convex fail when lifecycle management or _storage system table references are misconfigured. This skill provides a cohesive pattern for URL generation and storage mutations to ensure assets are served correctly.