Packages
A package is a single .zip file that bundles a campaign's content — articles, images, and portraits — together with a manifest.json describing what's inside. It is how you take your work out of GMTales and bring content back in.
Packages follow the same principle as everything else: plain Markdown is the source of truth. Articles travel as ordinary .md files, images as their original files, and the manifest is plain JSON — so a package is readable in any tool, inspectable, and stored however you like.
Exporting
From a campaign's Articles → Control panel → Export, download a package of your content: your articles — including private and secret paragraphs, since an export is always full-fidelity — plus the images and portraits you uploaded. The file is named gmtales-package-<campaign>-<timestamp>.zip.
Export is author-scoped: a package captures only the exporting author's articles. In a multi-author campaign there is no single "whole campaign" backup — each author exports their own.
Importing
Articles → Control panel → Import brings a package back in, two ways.
Sync — re-import your own work
Choose Sync to restore a package you exported — for example, after editing the Markdown offline. Articles are matched by their key and updated in place; articles with a new key are created. Images and portraits whose file name already exists are left untouched, so edits made in the app are never clobbered; genuinely new files are added. Sync continues past errors and reports the outcome of each item.
Import — merge someone else's pack
Choose Import to bring in a package from someone else. Import is fail-fast: every article and image is validated before anything is written. If a key clashes with an existing article, an article references a group your campaign doesn't have, an article is malformed, or an image name is already taken, the whole import is rejected and nothing is written — you get a list of exactly what to fix. Only once the package is wholly clean are the articles, images, and portraits committed and automatic links recomputed.
Partial packages
A package may contain any subset of sections. An articles-only pack imports without images; an images-only pack imports without articles. The manifest declares what's present, so importers read only what's there — and packages stay forward-compatible as new section types are added.