convex-file-storage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the entire process of handling files within Convex applications, from secure uploads to serving files via URLs and managing their metadata.

Core Features & Use Cases

  • File Uploads: Securely upload any file type (images, documents, etc.) with client-side previews.
  • File Serving: Automatically generate URLs to serve uploaded files directly.
  • Metadata Management: Store and retrieve file details like name, type, size, and upload time.
  • Action-based Storage: Store files generated by Convex actions (e.g., PDFs, images).
  • Deletion: Cleanly remove files from storage and associated database records.
  • Use Case: An e-commerce platform can use this Skill to allow users to upload product images, display them on product pages, and store order-related documents.

Quick Start

Use the convex-file-storage skill to upload an image file named 'profile.jpg' and save its reference.

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 backend?

To handle file uploads in a Convex backend, you can generate secure upload URLs, perform client-side uploads with previews, and save the associated file metadata to your database tables.

Can I store files generated by serverless actions in Convex?

Yes, you can store files generated by Convex serverless actions, such as PDFs or images, by saving them directly to file storage and recording their references in the database.

What is the best way to serve uploaded images from a Convex database?

The best way to serve uploaded images from a Convex database is to automatically generate and use file URLs that point directly to the stored files in your Convex storage.

Does Convex file storage support deleting files and their metadata?

Yes, Convex file storage supports deletion by cleanly removing the files from the storage system and deleting their associated database records to maintain data consistency.

What file types are supported for client-side uploads in Convex?

Convex file storage supports securely uploading any file type, including images and documents, while providing client-side previews before the upload process completes.