convex-file-storage

Automate file uploads, storage, retrieval, and deletion in Convex applications.

Updated Feb 8, 2026

Search Tags:#metadata #storage #convex #uploads #file-storage #urls #deletion

Ready to run

npx skills add https://github.com/gursheyss/styx --skill convex-file-storage-gursheyss

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/gursheyss/styx/tree/main/.agents/skills/convex-file-storage
Command: npx skills add https://github.com/gursheyss/styx --skill convex-file-storage-gursheyss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complete file handling in Convex apps, including upload flows, serving files via URL, storing generated files from actions, deletion, and accessing file metadata from system tables.

Core Features & Use Cases

Upload URLs and client-side uploads to store any file type (images, documents, generated assets).
Save and reference files in your own data model, retrieve URLs, and delete when needed.
Store generated artifacts from actions and serve them via stable URLs for user-facing experiences.

Quick Start

Use convex-file-storage to upload a file, save its reference, and retrieve a URL for display.

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 upload URLs for client-side uploads to store images, documents, and generated assets, then save their file references in your data model.

Can I store and serve generated files from Convex actions via URL?▼

Yes, you can store generated artifacts from Convex actions and serve them via stable URLs, providing reliable access to generated files for user-facing experiences alongside retrieving file metadata from system tables.

What is the best way to delete files and associated metadata in Convex?▼

The best way to delete files in Convex is to use a workflow that deletes the stored file along with its associated metadata, ensuring that both the file reference in your data model and the system storage entry are removed.

Does Convex file storage support accessing file metadata from system tables?▼

Yes, Convex file storage supports accessing file metadata from system tables, allowing you to retrieve URLs for display and manage file references effectively within your own data model after client-side uploads.

How do I generate upload URLs for client-side uploads in Convex?▼

You generate upload URLs in Convex to enable client-side uploads for storing any file type, then save the file references in your own data model and retrieve their URLs for display or deletion.

Are there limitations when serving stored files via URL in Convex?▼

Serving stored files via URL in Convex requires saving file references in your own data model first, and you must manage the lifecycle of these files by deleting both the file and its associated metadata when no longer needed.