Export and Migration

Brand Peel has two different export-related actions:

1. Project Export creates a readable package for one brand project
2. Export Data opens Brand Peel's raw local data directory so you can make your own full backup

Neither action uploads your projects or enables cloud sync.

Export a brand project

Open the project in Brand Creator and select Export in the top bar. The button appears once the project has at least one generated document or a theme.

Choose a parent destination folder. Brand Peel creates a new subfolder based on the project name and writes the available project files into it.

Package contents

Depending on what exists in the project, the package can contain:

• identity.md — Brand Identity
• visual.md — Visual Identity
• guidelines.md — Brand Guidelines
• theme.css — light and dark theme tokens as CSS custom properties
• theme.json — the raw light and dark theme-token object
• assets/logo-<id>.png — logo assets that have not been rejected
• .brand-peel-export.json — the export ownership marker

Empty documents, a missing theme, and rejected logos are skipped. The completion message reports how many files were written and names any files that failed.

Use the package outside Brand Peel

• Open the Markdown documents in a text editor or documentation tool
• Use theme.css in a web project or, once the Design Editor is available, import it through Import Theme
• Use theme.json as a machine-readable reference for the exported tokens
• Copy the PNG logo files into presentations, websites, or other design tools

The project package does not include the chat transcript, logo-direction batches or Node Builder graph, the global Resource Generator library, Design Sandbox sessions, or enough project metadata to recreate the project automatically.

Download standalone Resource Generator images from their local library. Export a Design Sandbox artifact from its own export menu when you need its source, artifact JSON, dependency manifest, or target-specific rendered output.

The package uses the theme saved on the brand project. Design Editor-only changes are not written back to that project automatically, so copy or download the current CSS from the editor when you need those newer changes.

Replacing a previous export

If the destination already contains the same project's earlier export, Brand Peel asks whether to replace it. Replacement is allowed only when the folder has both a valid Brand Peel marker and a matching destination record in the app's local data.

Brand Peel refuses to overwrite an unrelated folder. It stages the new files in a temporary directory before replacing the previous export and attempts to restore the previous folder if finalization fails.

Back up all local app data

Open Info > Export Data in the sidebar. Despite its label, this action opens Brand Peel's local data directory; it does not create a second copy automatically.

For a full raw backup:

1. Open the local data directory from Brand Peel
2. Close Brand Peel so files are not changing while you copy them
3. Copy the entire directory to an external drive or another trusted location

This raw directory contains data that is intentionally absent from a project package, including chat state, generated-image history, and Design Sandbox work.

Treat a raw-data backup as recovery material for the desktop app version that created it. Brand Peel does not currently provide a guided restore or data-directory import flow.

Move work to another device

Projects do not sync through your account, and there is no one-click migration workflow. To reuse the deliverables on another device:

1. Export the project on the old device
2. Copy the exported folder to the new device
3. Install Brand Peel and sign in
4. Create a new project if you need an editable Brand Peel workspace
5. Use the exported Markdown as source material, import theme.css after the Design Editor is available, and add the exported logo assets where needed

The original chat, acceptance history, Sandbox revisions, and project status are not reconstructed by these steps.

Backup checklist

Create a fresh project export for portable deliverables and a separate raw-data backup before:

• Reinstalling your operating system
• Replacing or resetting a computer
• Removing Brand Peel's local app data
• Making a major change to an important project

Next steps

• History — find, rename, and manage locally stored projects
• Installation — install Brand Peel on another device
• Account — understand which data is local and which requests use the API