Backup & restore
Export projects as JSON for metadata-only snapshots or ZIP archives that include generated source, configuration, uploaded assets, assistant chat history, and persisted chat conversations.
Choose a format
JSON is ideal for quick schema reviews in git. ZIP is the canonical full backup when you need binary fidelity or to migrate media.
- JSON enumerates asset counts without embedding files.
- ZIP places assets under an assets/ directory during import.
- Conversation history includes both project-level threads and ChatConversation rows (with new IDs on restore).
backup-export-flow
Import, clone, and restore
Import merges into an existing project when you want to overlay data. Creating from backup spins a new project id. Clone duplicates a live project—including Supabase metadata pointers but never third-party secrets—to accelerate staging environments.
Warning:
Service role keys are not exported. Re-enter secrets manually after cloning or importing.