Backup & restore

Export projects as JSON for metadata-only snapshots or ZIP archives that include generated source, configuration, uploaded assets, assistant chat history, persisted chat conversations, workflow definitions, and the latest screenshot.

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).
  • Workflow definitions are exported with inline secrets scrubbed (replaced by placeholders). Re-enter secrets after import.
  • The latest project screenshot is included and remapped to the new project slug on restore.

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.