Projects & Organization

After a few hundred generations, the difference between finding what you need in seconds and spending twenty minutes hunting through a flat pile of images comes down to one thing: project structure. Sweet Tea organizes all your work around Projects — named containers that keep inputs, outputs, masks, and metadata together by creative intent.

Creating a Project

Click New Project in the Projects section and give it a name that answers "what was this for?" six months from now.

Good names:

portrait-series-warm-tones
client-a-album-covers-march
fantasy-key-art-style-tests

Names to avoid:

test1
new-project
final-final-v2

Tip: Name projects by campaign, client, or creative goal rather than by date or technical setup. You'll search for "that album cover project" not "that March 15th project."

Folder Structure

Each project comes with a default folder structure:

project-name/
├── input/     # Source images, reference photos, condition images
├── output/    # Generated results
└── masks/     # Inpaint masks and selection masks

You can add custom folders for specific phases of your work (e.g., upscaled/, client-review/, finals/). Keep naming conventions consistent across projects so you can scan quickly.

How Project Context Affects Your Work

Your active project is more than a label — it shapes several behaviors:

Output routing — Generated images land in the active project's output folder.
Gallery filtering — Gallery views default to showing the active project's results.
Downstream organization — Curation, collections, and export workflows all respect project boundaries.

Before queueing a generation, glance at the project selector in Prompt Studio. If you're in the wrong project, your output ends up in the wrong place — not lost, but harder to find.

Moving and Reassigning Work

Images that landed in the wrong project (or runs you want to reorganize after the fact) can be moved:

Open Gallery and select the images you want to move.
Use the Move action and choose the destination project and folder.
Metadata continuity is preserved — the image keeps its full generation history.

You can also reassign entire jobs or runs to a different project from the gallery context menu. This is useful when you realize mid-session that you've been generating in the wrong project context.

Multiple Storage Roots

By default, all projects share a single data root directory. But if you need to spread work across different drives (e.g., a fast SSD for active work and a large HDD for archival projects), Sweet Tea supports multiple storage roots with per-project root mapping.

Configure additional storage roots in Settings, then assign specific projects to specific roots. This is especially useful for users with large model and output libraries that don't fit on a single drive.

Note: When you set a project to use a different storage root, existing files aren't automatically moved — you'll want to handle that migration yourself or start fresh in the new location.

Archiving

When a project is done and you don't need it in your active workspace anymore, archive it. Archiving hides the project from your default views without deleting anything.

You can unarchive a project at any time to bring it back. Archiving is meant for reducing clutter, not for permanent cleanup — if you want to permanently delete a project and its files, that's a separate (and more deliberate) action.

Tip: For client work, keep one project per client or campaign and one folder per milestone. Save your best prompt presets to the Prompt Library with matching tags so you can quickly pick up where you left off if the client comes back.

Next: Gallery & Results