convex-file-storage

Store, serve, and manage user-uploaded files with Convex storage.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/Noisemaker111/be-my-valentine --skill convex-file-storage-noisemaker111
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/Noisemaker111/be-my-valentine/tree/main/.agents/skills/convex-file-storage
Command: npx skills add https://github.com/Noisemaker111/be-my-valentine --skill convex-file-storage-noisemaker111

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Complete workflow for storing, serving, and managing user-uploaded files within Convex applications, including generated files and metadata tracking.

Core Features & Use Cases

  • Upload and store any file type (images, PDFs, docs) with URL-based serving
  • Retrieve file metadata and perform lifecycle operations (delete, update)
  • Integrate with mutations and queries to generate secure URLs and references

Quick Start

Follow the integration steps to configure storage, upload a file, and obtain a URL for serving.

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 storage in a Convex backend?

To handle file uploads and storage in a Convex backend, you use storage primitives alongside mutations and queries to upload files, generate secure URLs, and persist metadata references for retrieval and lifecycle management.

What is the best way to store and serve user-uploaded images in Convex?

The best way to store and serve user-uploaded images in Convex is by using its built-in storage primitives to upload the file, generate a URL for serving, and track the file's metadata through mutations and queries.

Can I manage file metadata and deletion with Convex storage?

Yes, you can manage file metadata and deletion with Convex storage by integrating mutations and queries to persist metadata references, update file properties, and perform lifecycle operations like deletion across your backend workflows.

Does Convex file storage work for documents and generated files?

Yes, Convex file storage works for documents and generated files, allowing you to store any file type, serve them via generated URLs, and track metadata across both frontend and backend application workflows.

How do I generate secure URLs for serving uploaded files in Convex?

You generate secure URLs for serving uploaded files in Convex by calling the appropriate storage query after the upload mutation completes, which returns a URL you can use to fetch the file on the frontend.