convex-file-storage

Automate file upload, storage, serving, and lifecycle management in Convex apps.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Katlyng/proy_vibetribe --skill convex-file-storage-katlyng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/Katlyng/proy_vibetribe/tree/main/.agents/skills/convex-file-storage
Command: npx skills add https://github.com/Katlyng/proy_vibetribe --skill convex-file-storage-katlyng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complete file handling 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: Generate signed URLs for uploading any file type to Convex storage.
  • Client-side Uploads: Allow browser-based uploads via the generated URL and track progress.
  • Saving File References: Persist file metadata and references in your application tables.
  • Serving Files via URL: Retrieve accessible URLs to display or download files.
  • Storing Generated Files from Actions: Create and store generated documents or images from server-side actions.
  • Accessing File Metadata: Read metadata from the _storage table, including size and type.
  • Deleting Files: Remove storage objects and associated references when no longer needed.

Quick Start

Request an upload URL, upload the file, and 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 in Convex?

To handle file uploads in Convex, you generate a signed upload URL, upload the file directly from the client browser, and then save the file reference and metadata in your application database.

What is the best way to serve stored files via URL in a Convex application?

The best way to serve files in Convex is to retrieve accessible URLs from the _storage system. This allows you to display or download stored files directly through generated links across web and server contexts.

Can I store generated files from server-side actions in Convex storage?

Yes, you can store generated files from server-side actions in Convex storage. This allows you to create and save generated documents or images directly within your application's automated workflows.

How do I access file metadata like size and type from the Convex _storage table?

You access file metadata by querying the Convex _storage system table. This allows you to read file attributes, including size and content type, for tracking and managing stored objects.

Does Convex file storage support client-side upload progress tracking?

Yes, Convex file storage supports client-side uploads via generated URLs, allowing browsers to upload any file type while tracking the upload progress directly in the web application.

How do I delete files and remove associated references in Convex?

To delete files in Convex, you remove the storage objects from the _storage system and delete any associated file references persisted in your application tables when they are no longer needed.