Skip to content

Backup System

Comic Shelf includes a versioned backup system to export and restore your collection.

Exporting

Navigate to Settings > Backup and click Export. This downloads a JSON file containing your entire collection.

Importing

Upload a previously exported JSON file. The backup system automatically migrates older backup versions to the current schema.

Versioning & Migrations

Each backup includes a version field. When importing, the system runs sequential migration functions to upgrade old backups:

V1 → V2 → V3 → current

When adding new database fields, the backup system must be updated — see CLAUDE.md for the full checklist.