convex-file-storage

Manage uploads, storage, serving, and metadata for files in Convex apps.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/danmarauda/agent-alias-configurator --skill convex-file-storage-danmarauda
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/danmarauda/agent-alias-configurator/tree/main/convexskills-main/skills/convex-file-storage
Command: npx skills add https://github.com/danmarauda/agent-alias-configurator --skill convex-file-storage-danmarauda

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex File Storage simplifies the lifecycle of files in Convex apps by providing built-in upload, storage, serving, and metadata access patterns for images, documents, and generated files.

Core Features & Use Cases

  • Upload URLs and storage: generate secure URLs for uploading files and store references in your data model.
  • Serve and access: serve files via generated URLs and query metadata such as file size, type, and creation time.
  • Generated content workflows: store outputs from actions (e.g., generated PDFs or images) for later retrieval and display.

Quick Start

Upload a sample file to generate a storage URL and retrieve the file metadata to verify the integration.

Frequently Asked Questions about convex-file-storage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload and store files in a Convex application?

Upload files in Convex by generating secure upload URLs, sending the file to that URL from the client, and then running a server mutation to store the resulting storage reference in your data model.

How does file serving and metadata access work in Convex?

File serving in Convex works by generating retrieval URLs for stored files, which can be used for display or download, while metadata queries allow you to access file size, type, and creation time.

Can I store generated files like PDFs and images using Convex file storage?

Yes, Convex file storage supports generated content workflows, allowing you to store outputs from actions such as generated PDFs or images for later retrieval and display via generated URLs.

Do I need client-side upload URLs to manage file storage in Convex?

Yes, client-side uploads in Convex require generating secure upload URLs to send the file directly, after which a server mutation stores the reference, ensuring reliable file storage without exposing backend credentials.

What is the best way to manage end-to-end file lifecycle in Convex apps?

Managing the end-to-end file lifecycle in Convex involves using upload URLs for ingestion, server mutations for reference storage, URL generation for serving, and metadata queries to track file attributes like size and type.