convex-backup

Automates Convex snapshot exports and verifies recovery through restore drills into throwaway preview deployments.

1|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/Rocktown-Labs/rivercitymd --skill convex-backup-rocktown-labs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-backup
Source: https://github.com/Rocktown-Labs/rivercitymd/tree/main/.agents/skills/convex-backup
Command: npx skills add https://github.com/Rocktown-Labs/rivercitymd --skill convex-backup-rocktown-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Most teams take database backups but never test whether those backups actually restore, leaving them exposed when a real disaster hits. This Skill sets up scheduled Convex snapshot exports and runs a restore drill that recovers the data into a disposable preview deployment and asserts it came back intact. ## Core Features & Use Cases - Snapshot Export: Takes a portable backup artifact with npx convex export, optionally including file storage, and recommends a schedule matched to your RPO with a retention window. - Restore Drill: Deploys a throwaway preview with npx convex deploy --preview-create, imports the snapshot into it, and asserts critical tables came back with expected row counts and real record samples. - Recovery Runbook: Produces a deploy-guard-gated runbook with the exact commands to restore to production, including the post-snapshot write-loss caveat. - Use Case: Before a major launch, run the drill to prove your nightly Convex exports actually restore — if the import lands zero rows, you find out now instead of during an outage. ## Quick Start Set up a daily Convex backup schedule and run a restore drill to verify my data can actually be recovered.

Frequently Asked Questions about convex-backup

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

FAQPage Schema
Should I commit Convex backup files to git?▼

No. Snapshots contain sensitive real data and must never be committed. Delete local copies when the drill finishes; the throwaway preview deployment auto-expires on its own.