Skip to content

Add merch catalogue by business type, photo mockups, examples and install docs - #1

Merged
shadowtor merged 2 commits into
mainfrom
feat/brand-studio-v1
Oct 15, 2026
Merged

shadowtor merged 2 commits into
mainfrom
feat/brand-studio-v1

Conversation

@shadowtor

Copy link
Copy Markdown
Owner

What this adds

  • Merch by business type (merch_catalog.py): coffee, gaming, tech, artist, retail and more, so a roaster gets a bean bag and travel mug, a gaming community a jersey and mouse mat, a tech company a USB stick, cable and lanyard.
  • Photographic mockups (opt-in --photo-mockups): psd_mockup.py fills the smart-object design layers of free mockups-design.com PSDs (downloaded on demand, cached, never committed). Items with no free PSD get a labelled illustration. The guidelines "In use" pages are built from mockups/manifest.json, so only real files are shown.
  • Fixes found while building the examples: logo proportions in stretched smart objects, multi-layer PSDs (cups, desk scenes), median colour sampling, favicon legibility on dark tabs (favicon_source, app_icon), guideline PDFs 35 MB -> ~1 MB.
  • Install and docs: tools/install.py, check_setup.py, docs/INSTALL-FOR-AGENTS.md (copy-paste for agents), full README with credits, CONTRIBUTING.md, hardened .gitignore/.gitattributes.
  • Three fictional examples: Kiln (coffee), Rookery (gaming), Marigold Press (illustrator).

Test plan

  • python tools/smoke_test.py passes locally on Windows (38 s)
  • CI smoke test on ubuntu/macos/windows (first run of .github/workflows/test.yml)
  • Review: path handling on macOS/Linux (tools/install.py, scripts/*.py), subprocess usage, the PSD download flow in psd_mockup.py, anything that could write outside the chosen output folder

Third-party material: reference logo/palette libraries are study-only (see THIRD_PARTY_NOTICES.md); no PSD files are in the repo.

🤖 Generated with Claude Code

…tall docs

- merch_catalog.py: business type -> items a brand of that kind really makes
  (coffee, gaming, tech, artist, retail and more), with per-item placement tweaks
- psd_mockup.py: fill every design smart object, compensate non-uniform boxes,
  median colour sampling; opt-in --photo-mockups in build_kit.py
- 11 more labelled illustration scenes for items without a free PSD
- guidelines "In use" pages are built from mockups/manifest.json (real files only);
  embedded images compressed (PDFs ~35 MB -> ~1 MB)
- favicon_source and app_icon options so marks stay legible on dark tabs
- check_setup.py, tools/install.py, INSTALL-FOR-AGENTS.md, CONTRIBUTING.md
- three fictional examples: Kiln, Rookery, Marigold Press
- README rewritten with install options, agent copy-paste and credits
- .gitignore / .gitattributes hardened (no PSDs, kits or caches)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-15T01:10:08.670426Z a52d558 Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@shadowtor

Copy link
Copy Markdown
Owner Author

@codex review

Please focus on: cross-platform path handling (macOS/Linux) in tools/install.py and skills/brand-studio/scripts/*.py, subprocess and download handling in psd_mockup.py (zip extraction, cache folder), anything that could write outside the chosen output folder, and errors in the docs/README install steps.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a52d558262

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

- psd_mockup.py: match skip words as whole words so "Place your design here"
  is no longer skipped by "lace"; design/logo/artwork names win over the skip list
- psd_mockup.py: drop deprecated Image.getdata (median ground colour via numpy)
- check_setup.py, INSTALL-FOR-AGENTS.md, README: the no-uv pip fallback now includes
  pymupdf (and the photo-mockup packages)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@shadowtor
shadowtor merged commit b762b5b into main Oct 15, 2026
3 checks passed
@shadowtor
shadowtor deleted the feat/brand-studio-v1 branch October 15, 2026 01:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant