convex-file-storage

Manage file uploads, serving, and deletion in Convex applications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the entire process of managing files within Convex applications, from secure uploads to serving and deletion.

Core Features & Use Cases

  • File Uploads: Handles secure file uploads with generated URLs.
  • File Serving: Provides direct URLs for accessing stored files.
  • Metadata Management: Integrates with Convex's _storage system table for file details.
  • Action-based Storage: Supports storing files generated by Convex actions.
  • Deletion: Manages the removal of both storage files and database references.
  • Use Case: Enable users to upload profile pictures, store generated reports, or attach documents to records in your Convex application.

Quick Start

Use the convex-file-storage skill to generate an upload URL for a new 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 Convex?

File uploads in Convex are handled by generating secure upload URLs, storing files via mutations and actions, and managing references through the _storage system table. This process supports various file types for application use.

What is the best way to store generated files from Convex actions?

The best way to store generated files from Convex actions is to use action-based storage mutations. This method directly saves the output into the _storage system table, automatically managing metadata and providing a URL for serving the file.

How does file deletion work with the Convex _storage system table?

File deletion with the Convex _storage system table requires removing both the physical storage file and its database references. This ensures that metadata tracked in the system table stays synchronized and prevents orphaned file records.

Can I serve stored files directly through URLs in my Convex application?

Yes, you can serve stored files directly through URLs in your Convex application. Once a file is uploaded and stored via mutations, the system generates direct URLs that allow clients to access and download the file securely.

Does Convex file storage support managing metadata for various file types?

Yes, Convex file storage supports managing metadata for various file types. It integrates directly with the _storage system table to automatically track file details, ensuring documents, profile pictures, and generated reports are properly cataloged.