convex-file-storage

Implement file upload, storage, serving, and management workflows for Convex backend applications.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/wixels/sab-colour-profile --skill convex-file-storage-wixels
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-file-storage
Source: https://github.com/wixels/sab-colour-profile/tree/main/.agents/skills/convex-file-storage
Command: npx skills add https://github.com/wixels/sab-colour-profile --skill convex-file-storage-wixels

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the complexity of building custom file management infrastructure for Convex applications, providing pre-built, secure patterns for all common file handling tasks.

Core Features & Use Cases

  • Full File Lifecycle Support: Handle uploads, public URL serving, metadata access, and deletion for all file types including images, PDFs, and generated files.
  • Pre-built Integration Patterns: Ready-to-use code for client-side uploads, action-based file generation, and image preview functionality.
  • Use Case: For example, use this Skill to quickly add user avatar uploads or PDF report serving to your Convex app without writing boilerplate storage logic.

Quick Start

Use the convex-file-storage skill to add image upload with preview and persistent storage to your Convex React application.

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

To handle file uploads and storage in a Convex backend, you use pre-built integration patterns for client-side uploads, generating files via actions, and serving public URLs. This eliminates the need to write custom storage logic and boilerplate code.

What is the best way to serve static assets like images and PDFs using Convex?

The best way to serve static assets like images and PDFs using Convex is to utilize native storage integration patterns that provide public URLs for uploaded files. This approach supports reliable serving workflows and allows quick implementation of features like image previews.

Can I store files generated by server actions in Convex and track their metadata?

Yes, you can store files generated by Convex actions and track their metadata. The implementation supports accessing file metadata directly from Convex system tables, ensuring proper validation and tracking for server-generated content.

Does Convex file storage support secure deletion of orphaned files?

Yes, Convex file storage workflows support secure deletion of orphaned files. The implementation includes proper file validation, metadata tracking, and management capabilities to ensure reliable deletion across the full file lifecycle.

How do I add user-generated content uploads to my React and Convex application?

To add user-generated content uploads to a React and Convex application, apply ready-to-use client-side upload patterns with persistent storage. This provides full lifecycle support for all file types, including images and PDFs, without building custom infrastructure.