ConvexFS

ConvexFS is a Convex component that provides filesystem-like operations for managing files in your Convex application. Instead of dealing with raw blob storage, you work with familiar concepts like paths, files, and directories—while getting the performance benefits of a global CDN.

Features

• Path-based file management — Organize files with familiar filesystem paths
• Atomic transactions — Move, copy, and delete files with preconditions to prevent data races
• Reference-counted blobs — Efficient storage with automatic deduplication
• Signed CDN URLs — Secure, time-limited download links served from Bunny.net's global edge network
• Soft deletes & disaster recovery — Configurable grace periods let you recover from accidental deletions
• Flexible authentication — Bring your own auth logic for uploads and downloads

Example app

The repository includes a runnable example app that allows you to curate a photo gallery.

Status

Alpha — This project is in active development. APIs may change before 1.0.

Documentation

For installation instructions, guides, and API reference, visit:

convexfs.dev

License

Apache-2.0