convex-file-storage

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

Updated Nov 2, 2025
One-click install
npx skills add https://github.com/cpmappstudio/cpca-sports --skill convex-file-storage-cpmappstudio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/cpmappstudio/cpca-sports/tree/main/.agents/skills/convex-file-storage
Command: npx skills add https://github.com/cpmappstudio/cpca-sports --skill convex-file-storage-cpmappstudio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex file storage solves the pain of building end-to-end file workflows by handling uploads, persistent storage, URL serving, and metadata access in a single, managed pattern.

Core Features & Use Cases

  • Upload Files: generate secure upload URLs and store references to uploaded files.
  • Serve Files & Metadata: retrieve public URLs and access file metadata from the system tables.
  • Generated Content & Cleanup: store generated files from actions and delete files when no longer needed.
  • Use Case: Attach user avatars, documents, images, and generated reports within Convex apps.

Quick Start

Integrate Convex file storage by generating an upload URL, posting a file, and saving its metadata.

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 Convex applications?

File uploads and storage in Convex applications are handled by generating secure upload URLs, posting files to those endpoints, and saving the associated file metadata for later retrieval. This provides a managed pattern for end-to-end file workflows.

Can I store generated files and reports from actions in Convex file storage?

Yes, Convex file storage supports storing generated content and reports from backend actions. You can save generated files to the storage backend and retrieve their serving URLs to access them within your application workflows.

How do I retrieve file metadata and serving URLs from Convex system tables?

Retrieving file metadata and serving URLs in Convex involves accessing the system tables where file references are saved. The API surface provides methods to fetch public serving URLs and associated metadata for uploaded documents and images.

What is the best way to manage user-generated content like avatars and documents in Convex?

The best way to manage user-generated content in Convex is using a consistent storage backend pattern that handles secure upload URL generation, metadata saving, and public URL retrieval, enabling complete workflows from upload to serving.

Does Convex file storage support deleting stored files when they are no longer needed?

Yes, Convex file storage supports deleting stored files for content cleanup. You can remove files from the storage backend when they are no longer needed, ensuring efficient management of user-generated images, documents, and reports.