Guide

Practical advice, workflows, and tips for using Brand Peel, whether you are building your first brand or updating an existing one.

A practical Brand Peel workflow

Start with the Brand Creator. Describe the product, audience, problem, differentiators, and desired personality.
Shape the documents and theme. Review generated work, edit it directly, and use message versions to explore alternatives.
Prototype before everything is final. Design Sandbox is available whenever a project is active and can use its current documents, theme, and accepted assets as context.
Finish the local setup. Accept all three brand documents, then choose Finish Setup to mark the project complete and unlock the Resource Generator. This does not publish it to a public service.
Refine and generate. Tune the theme in the Design Editor, then create final image assets with the Resource Generator.
Export and back up. Create a portable project snapshot and separately back up Brand Peel's live data directory.

Getting the best AI results

The Brand Creator chat shapes your documents, theme, and assets. A clearer conversation usually means better output.

Be specific about your audience

Instead of "I sell software," try:

"I sell project management software to small creative agencies who are frustrated with overly complex tools."

The AI uses audience details to shape tone, messaging, and visual direction.

Describe the feeling, not just the features

Brands carry emotion. Tell the AI how you want people to feel:

"I want it to feel approachable but quietly confident, like a trusted colleague, not a corporate vendor."

Use visual references deliberately

Attach images to the chat:

Mood boards showing color palettes you like
Competitor logos to contrast against
Screenshots of apps or websites with a style you admire

The AI can read these and factor them into the visual identity. Attachments are saved with the local conversation and sent with the relevant AI request, so only attach material you are comfortable having processed by the Brand Peel service and its AI provider.

Iterate with versioning

If an AI response is close but not quite right, use regenerate to explore alternatives. You can switch between versions without losing your place in the conversation. This works well for:

Finding the right tagline
Trying different positioning angles
Testing visual directions

Prototyping in Design Sandbox

Design Sandbox turns the active project's context into interactive, branded prototypes. It supports six targets:

shadcn-style websites
React Email layouts
React PDF documents
React Native mobile screens
Ink terminal interfaces
React Three Fiber 3D scenes

Choose a target, then select a category, preset, and modules where available. Start with a concrete job such as “create a launch email for existing trial users” or “build a mobile pricing screen with three options.” Brand Peel combines that request with the project's current context and theme.

After the first result, select elements in the preview and ask for focused revisions. Each new generation or revision uses one chat-message credit or one unit from the Pro chat quota. Editing the local artifact directly does not use AI allowance.

Sandbox conversations and artifacts are saved inside the local project. They are not currently included in the portable project export, so back up the live data directory if you need to preserve them outside the app.

Organizing your projects

As you create more brands, keeping History tidy pays off.

Name projects clearly when you create them (e.g., "Acme Corp — Q3 Rebrand" instead of "Untitled")
Delete drafts you are sure you will not revisit
Export finished projects before major changes, so you have a snapshot to return to
Use batch selection to clean up groups of old experiments at once

Using the Design Editor effectively

Start from a preset

If you are unsure where to begin, apply a built-in preset that feels close to your vision, then tweak it. Faster than building a theme from scratch.

Test both modes early

Switch between light and dark mode as you edit. A color that looks great in one mode may need adjustment in the other.

Trust the contrast checker

Accessibility matters here. If the editor warns you about contrast, take it seriously. Use Fix Contrast or adjust lightness manually until the warning clears.

Export early and often

Copy your CSS as soon as you have a theme you like. Paste it into a real project or show it to stakeholders. Context reveals issues that are hard to spot in the preview alone.

Generating useful images

Match the model to the task

Use Nano Banana for quick drafts, concepts, and social media
Use Imagen 4 Ultra for detailed illustrations and product visuals
Use Nano Banana Pro when you need the highest fidelity

Write prompts that include brand context

The Resource Generator does not automatically know your brand, so include that context in your prompt:

"A minimalist app icon for a meditation brand, soft sage green tones, rounded shapes, calming and modern"

Reuse successful prompts

When a generation turns out well, save the prompt somewhere. Small variations on a working prompt often produce the best series of assets.

Understanding AI usage

AI-backed actions draw from your Free credits or Pro quotas. These include Brand Creator messages, separate document and theme generations, logo-direction requests, Design Sandbox generations and revisions, and Resource Generator images.

Local work does not consume AI allowance. You can review and edit saved documents, adjust the theme manually, organize History, work on an existing Sandbox artifact without requesting a revision, and export files without spending credits or quota.

Image models can consume different amounts at different resolutions. Check Credits and Usage before a batch generation so you know whether an action draws from the Chat Messages, Standard Quality, or Best Quality allowance.

Exporting and keeping your work safe

Brand Peel provides two different ways to access your work:

Export in the project workspace creates a new snapshot in a folder you choose. It includes available brand documents as Markdown, the theme as CSS and JSON, and non-rejected project logos as PNG files.
Export Data in the sidebar opens Brand Peel's live local data directory. Despite the label, it does not create a second copy. Use Open Location or copy the displayed path when you need to inspect or back up the complete workspace, including chat and Design Sandbox data.

For safer backups:

Create a project export before major revisions or handoff.
Back up the live data directory before OS updates, migrations, or hardware changes.
Store backups in a cloud-synced folder or external drive if that fits your security policy.
Remember that project exports are snapshots; later edits in Brand Peel do not update them automatically.

Next steps

Introduction — review the core concepts and local/cloud boundary
First Steps — walk through creating your first brand
Credits and Usage — understand AI costs and plan quotas
Export and Migration — back up or move the local workspace