feat: portable self-contained brand kit in exports/ #10

Merged
brad merged 2 commits from feat/portable-exports-kit into main 2026-02-27 13:15:21 -08:00
Owner

Summary

  • Moves brand.css from repo root into assets/exports/, making the exports directory a fully portable brand kit
  • Bundles all assets — fonts, logos, swatches, and a logo zip are copied into exports with ./ relative paths
  • Adds Brand Tools section to the showcase with embedded data-URI download buttons (works from file://)
  • Improves showcase — role labels on colors, accessible button styling from approved pairs, accessibility sections moved above typography

What changed

File Change
scripts/build.py New _copy_exports_assets(), CSS output path, font-face URLs, showcase sections reordered, data-URI downloads
.forgejo/workflows/build.yml Removed brand.css from git add (now inside assets/exports/)
CLAUDE.md Updated architecture diagram and generated files note
README.md Updated mermaid diagram and repository structure tree
brand.css (deleted) No longer generated at root

After build, exports/ contains:

assets/exports/
├── index.html              (showcase with embedded downloads)
├── brand.css               (font paths use ./fonts/)
├── fonts/                  (copies of referenced font files)
├── logos/                  (copies of logo files)
├── swatches/               (copies of swatch PNGs)
├── {name}-logos.zip        (all logos in one zip)
├── {name}.ase / .gpl / .scss / .tokens.json / .swatches / .tailwind.js

Test plan

  • Full pipeline passes with full brand and minimal example
  • No brand.css at repo root after build
  • Exports dir is portable (copy elsewhere, open index.html — works)
  • Download buttons trigger save dialogs, not inline display
  • Light/dark toggle and mermaid diagram render

🤖 Generated with Claude Code

## Summary - **Moves `brand.css`** from repo root into `assets/exports/`, making the exports directory a fully portable brand kit - **Bundles all assets** — fonts, logos, swatches, and a logo zip are copied into exports with `./` relative paths - **Adds Brand Tools section** to the showcase with embedded data-URI download buttons (works from `file://`) - **Improves showcase** — role labels on colors, accessible button styling from approved pairs, accessibility sections moved above typography ## What changed | File | Change | |---|---| | `scripts/build.py` | New `_copy_exports_assets()`, CSS output path, font-face URLs, showcase sections reordered, data-URI downloads | | `.forgejo/workflows/build.yml` | Removed `brand.css` from `git add` (now inside `assets/exports/`) | | `CLAUDE.md` | Updated architecture diagram and generated files note | | `README.md` | Updated mermaid diagram and repository structure tree | | `brand.css` (deleted) | No longer generated at root | ## After build, exports/ contains: ``` assets/exports/ ├── index.html (showcase with embedded downloads) ├── brand.css (font paths use ./fonts/) ├── fonts/ (copies of referenced font files) ├── logos/ (copies of logo files) ├── swatches/ (copies of swatch PNGs) ├── {name}-logos.zip (all logos in one zip) ├── {name}.ase / .gpl / .scss / .tokens.json / .swatches / .tailwind.js ``` ## Test plan - [ ] Full pipeline passes with full brand and minimal example - [ ] No brand.css at repo root after build - [ ] Exports dir is portable (copy elsewhere, open index.html — works) - [ ] Download buttons trigger save dialogs, not inline display - [ ] Light/dark toggle and mermaid diagram render 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Move brand.css output into assets/exports/ so the exports directory
is fully portable — copy it anywhere and everything works. The
showcase HTML, fonts, logos, and swatches are all bundled with
relative paths.

Changes:
- brand.css now generated into assets/exports/ instead of root
- Font-face URLs use ./fonts/filename instead of repo-relative paths
- New _copy_exports_assets() copies fonts, logos, swatches into exports
- Logo zip file generated for easy download
- Brand Tools section with embedded data-URI download buttons
- Accessible button colors from first approved pair
- Role color labels now show the role (Primary, Secondary, Text)
- Accessibility sections moved above Typography in showcase
- Updated CI workflow, CLAUDE.md, and README.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
brad merged commit 4da7b19161 into main 2026-02-27 13:15:21 -08:00
brad deleted branch feat/portable-exports-kit 2026-02-27 13:15:21 -08:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
brad/brand-guidelines!10
No description provided.