Step-by-step: where to put logotype, colors, and setup files
Use this guide to add your logotype, color palette, and other brand setup files so the marketing agent and future Ziggies agents can use them.
1. Logotype (logo files)
Where: Put all logo files in:
workspace/ziggies-marketing/brand/logo/
What to put there:
| File (example) | Purpose |
|---|---|
logo.svg |
Main logo, vector (preferred for web and print). |
logo.png |
Raster version, e.g. for social or email (recommended: transparent background, high resolution). |
logo-light.png or logo-dark.png |
Variants for light/dark backgrounds if you have them. |
favicon.ico or favicon.png |
Site favicon (optional; can live here or in a web repo later). |
Steps:
- Create the folder if it doesn’t exist:
workspace/ziggies-marketing/brand/logo/. - Copy your logotype files into
brand/logo/. - Name them clearly (e.g.
ziggies-logo.svg,ziggies-logo-white.png). The agent will use whatever you put in this folder.
2. Color palette
Where: Put color definitions in:
workspace/ziggies-marketing/brand/colors/
What to put there:
| File (example) | Purpose |
|---|---|
palette.md |
Human-readable list of colors (names, hex/codes, usage). Recommended as the main reference. |
palette.json |
Same palette in JSON (e.g. for tools or other agents). Optional. |
| Export from design tool | If you have .ase, .sketch, or similar, you can put them here and reference them in palette.md. |
Steps:
- Create the folder:
workspace/ziggies-marketing/brand/colors/. - Add
palette.mdwith your colors, for example: - Color name
- Hex code (e.g.
#RRGGBB) - Short note on usage (e.g. “Primary brand”, “Background”, “Text”).
- Optionally add
palette.jsonor design-tool exports in the same folder.
3. Other setup files / structure
Where: General brand assets and setup docs go in:
workspace/ziggies-marketing/brand/
Suggested layout:
workspace/ziggies-marketing/brand/
├── 00-brand-facts.md ← Website, social, language (already there)
├── SETUP-INSTRUCTIONS.md ← This file
├── logo/ ← Logotype files (see step 1)
│ ├── logo.svg
│ └── logo.png
├── colors/ ← Color palette (see step 2)
│ ├── palette.md
│ └── palette.json (optional)
└── assets/ ← Optional: other brand assets (fonts, patterns, etc.)
Steps:
- Logotype: Follow step 1 above and fill
brand/logo/. - Colors: Follow step 2 above and fill
brand/colors/. - Extra assets: If you have font specs, pattern files, or other brand assets, create
brand/assets/and put them there. Add a shortbrand/assets/README.mddescribing what each file is for.
4. After you add the files
- The Ziggies Marketing agent will use everything under
brand/(including00-brand-facts.md) when working in this workspace. - You can say in chat: “Use the logo in
brand/logo/and colors frombrand/colors/palette.md” for copy or briefs. - Future agents (e.g. ziggies-web) can read the same paths for site design and consistency.
If you want to change folder names or add more folders (e.g. brand/typography/), update this file and the agent will follow the new structure.