Skip to content

docs: redesign logo as flat vector flag mark#714

Merged
jdx merged 1 commit into
mainfrom
claude/funny-jennings-429a41
Jul 7, 2026
Merged

docs: redesign logo as flat vector flag mark#714
jdx merged 1 commit into
mainfrom
claude/funny-jennings-429a41

Conversation

@jdx

@jdx jdx commented Jul 7, 2026

Copy link
Copy Markdown
Owner

Summary

Redesigns the Usage logo, replacing the AI-generated raster --help flag with a clean, flat vector version of the same concept — an ink flagpole with a green swallowtail banner carrying the -- flag prefix. Keeps the beloved "CLI flag" pun while giving us crisp, scalable, on-brand assets that hold up at every size (including 16px favicons).

What changed

  • icon.svg — new canonical vector source, also registered as a modern image/svg+xml favicon.
  • Regenerated every derived asset from the vector at its original dimensions:
    • logo.png (1536×1024), logo-nav.png (1014×399)
    • favicon-16x16.png, favicon-32x32.png, favicon.ico (16+32 frames)
    • apple-touch-icon.png (180), android-chrome-192x192.png, android-chrome-512x512.png
  • Banner green is #22c55e, matching --usage-green in the docs palette and the existing theme-color.
  • App icons (apple-touch, android-chrome — the latter doubles as the OpenGraph/Twitter image) use an opaque white tile so they render correctly as home-screen icons and social cards; favicons and logos stay transparent.

No filenames or dimensions changed, so the VitePress config, webmanifest, and hero component all keep working; the only config edit adds the SVG favicon link.

🤖 Generated with Claude Code


Note

Low Risk
Docs-only branding and favicon metadata; no application or security-sensitive code paths change.

Overview
Replaces the docs site branding with a flat vector flag mark (icon.svg)—pole plus green (#22c55e) swallowtail banner with -- bars—serving as the canonical scalable asset.

VitePress head now links /icon.svg as image/svg+xml before the existing PNG favicon entries, so browsers that support SVG favicons pick up the new mark without changing paths for logo-nav.png, webmanifest, or OpenGraph URLs.

Reviewed by Cursor Bugbot for commit 1b0d8a4. Bugbot is set up for automated code reviews on this repo. Configure here.

Summary by CodeRabbit

  • Documentation
    • Updated the documentation site to include a new SVG favicon in the browser tab.

Replace the raster `--help` flag logo with a clean, flat vector design
based on the same pennant concept: an ink flagpole and a green (#22c55e,
matching the brand palette) swallowtail banner bearing the `--` flag
prefix.

- Add icon.svg as the canonical vector source and register it as a
  modern SVG favicon.
- Regenerate every derived asset from the vector at its original
  dimensions: logo.png, logo-nav.png, favicon-16/32, favicon.ico
  (16+32), apple-touch-icon, and android-chrome 192/512.
- App icons (apple-touch, android-chrome) use an opaque white tile so
  they render correctly as home-screen icons and OpenGraph/social
  cards; favicons and logos stay transparent.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Central YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 356c22e0-e1f2-4340-9bdc-0003e907503e

📥 Commits

Reviewing files that changed from the base of the PR and between 8e4e785 and 1b0d8a4.

⛔ Files ignored due to path filters (9)
  • docs/public/android-chrome-192x192.png is excluded by !**/*.png
  • docs/public/android-chrome-512x512.png is excluded by !**/*.png
  • docs/public/apple-touch-icon.png is excluded by !**/*.png
  • docs/public/favicon-16x16.png is excluded by !**/*.png
  • docs/public/favicon-32x32.png is excluded by !**/*.png
  • docs/public/favicon.ico is excluded by !**/*.ico
  • docs/public/icon.svg is excluded by !**/*.svg
  • docs/public/logo-nav.png is excluded by !**/*.png
  • docs/public/logo.png is excluded by !**/*.png
📒 Files selected for processing (1)
  • docs/.vitepress/config.mts

📝 Walkthrough

Walkthrough

Added a new favicon link entry (SVG icon) to the VitePress site configuration's head array, alongside the existing favicon and meta tags.

Changes

Favicon Configuration

Layer / File(s) Summary
Add SVG favicon entry
docs/.vitepress/config.mts
Added a new <link rel="icon" href="/icon.svg"> entry to the head array, keeping existing favicon and meta tags unchanged.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Poem

A tiny icon, sharp and new,
Vector lines in every hue,
One small link, tucked in the head,
"/icon.svg" is what it said.
Hop hop hooray, the favicon's spread! 🐇✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly matches the main change: redesigning the logo into a flat vector flag mark.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@jdx
jdx enabled auto-merge (squash) July 7, 2026 16:06
@greptile-apps

greptile-apps Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Replaces the AI-generated raster logo with a clean vector redesign — a flat SVG flag mark (icon.svg) and regenerated PNG/ICO derivatives at every existing size. The sole config change registers the SVG as a modern image/svg+xml favicon ahead of the existing PNG fallbacks, which is the correct browser-priority ordering.

  • icon.svg — new 512×512 canonical vector source: ink pole, green (#22c55e) swallowtail banner, two white rounded-rect dashes for the -- pun; includes role="img", aria-label, and <title> for accessibility.
  • All derived assets (logo.png, logo-nav.png, favicons, Apple/Android icons) regenerated at their original dimensions and filenames so no VitePress config, webmanifest, or hero-component references break.
  • App icons (apple-touch, android-chrome) use an opaque white background for correct home-screen and social-card rendering; favicons and logos stay transparent.

Confidence Score: 5/5

Safe to merge — this is a docs-only asset swap with no runtime logic changes.

All filenames and dimensions are preserved so existing config references remain valid. The single config edit adds the SVG favicon link in the correct position before PNG fallbacks. The SVG is well-formed, minimal, and includes proper accessibility attributes. No build pipeline or application logic is touched.

No files require special attention.

Important Files Changed

Filename Overview
docs/.vitepress/config.mts Adds SVG favicon link before the existing PNG fallbacks — correct browser-priority ordering for modern favicon discovery.
docs/public/icon.svg New canonical vector logo — flag pole with green swallowtail banner and two white rounded-rect dashes representing --. Includes role=img, aria-label, and a title element for accessibility.
docs/public/favicon-16x16.png Regenerated 16x16 PNG favicon derived from the new vector source.
docs/public/favicon-32x32.png Regenerated 32x32 PNG favicon derived from the new vector source.
docs/public/favicon.ico Regenerated multi-frame ICO (16+32) from the vector source.
docs/public/apple-touch-icon.png Regenerated 180x180 Apple touch icon with opaque white tile background for correct home-screen rendering.
docs/public/android-chrome-192x192.png Regenerated 192x192 Android Chrome icon with opaque white background.
docs/public/android-chrome-512x512.png Regenerated 512x512 Android Chrome icon with opaque white background; used as OpenGraph and Twitter card image.
docs/public/logo.png Regenerated 1536x1024 primary logo PNG from the vector source at original dimensions.
docs/public/logo-nav.png Regenerated 1014x399 navigation bar logo PNG from the vector source at original dimensions.

Reviews (1): Last reviewed commit: "docs: redesign logo as flat vector flag ..." | Re-trigger Greptile

@jdx
jdx merged commit 67e05ff into main Jul 7, 2026
5 of 6 checks passed
@jdx
jdx deleted the claude/funny-jennings-429a41 branch July 7, 2026 16:07
@mise-en-dev mise-en-dev mentioned this pull request Jul 7, 2026
mise-en-dev added a commit that referenced this pull request Jul 14, 2026
### 🐛 Bug Fixes

- **(parse)** allow hyphen-prefixed flag values by
[@jdx](https://github.com/jdx) in
[#715](#715)

### 📚 Documentation

- redesign logo as flat vector flag mark by
[@jdx](https://github.com/jdx) in
[#714](#714)

### 🧪 Testing

- invoke typescript compiler through npx package by
[@jdx](https://github.com/jdx) in
[#719](#719)

### 🔍 Other Changes

- **(release)** skip ai reviews for release prs by
[@jdx](https://github.com/jdx) in
[#718](#718)
- schedule releases for Monday morning by [@jdx](https://github.com/jdx)
in [#710](#710)
- gate autorelease on fix and feat commits by
[@jdx](https://github.com/jdx) in
[#716](#716)
tmeijn pushed a commit to tmeijn/dotfiles that referenced this pull request Jul 15, 2026
This MR contains the following updates:

| Package | Update | Change |
|---|---|---|
| [usage](https://github.com/jdx/usage) | patch | `3.5.4` → `3.5.5` |

MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot).

**Proposed changes to behavior should be submitted there as MRs.**

---

### Release Notes

<details>
<summary>jdx/usage (usage)</summary>

### [`v3.5.5`](https://github.com/jdx/usage/blob/HEAD/CHANGELOG.md#355---2026-07-13)

[Compare Source](jdx/usage@v3.5.4...v3.5.5)

##### 🐛 Bug Fixes

- **(parse)** allow hyphen-prefixed flag values by [@&#8203;jdx](https://github.com/jdx) in [#&#8203;715](jdx/usage#715)

##### 📚 Documentation

- redesign logo as flat vector flag mark by [@&#8203;jdx](https://github.com/jdx) in [#&#8203;714](jdx/usage#714)

##### 🧪 Testing

- invoke typescript compiler through npx package by [@&#8203;jdx](https://github.com/jdx) in [#&#8203;719](jdx/usage#719)

##### 🔍 Other Changes

- **(release)** skip ai reviews for release prs by [@&#8203;jdx](https://github.com/jdx) in [#&#8203;718](jdx/usage#718)
- schedule releases for Monday morning by [@&#8203;jdx](https://github.com/jdx) in [#&#8203;710](jdx/usage#710)
- gate autorelease on fix and feat commits by [@&#8203;jdx](https://github.com/jdx) in [#&#8203;716](jdx/usage#716)

</details>

---

### Configuration

📅 **Schedule**: (UTC)

- Branch creation
  - At any time (no schedule defined)
- Automerge
  - At any time (no schedule defined)

🚦 **Automerge**: Enabled.

♻ **Rebasing**: Whenever MR is behind base branch, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this MR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this MR, check this box

---

This MR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My4yNTcuMiIsInVwZGF0ZWRJblZlciI6IjQzLjI1Ny4yIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJSZW5vdmF0ZSBCb3QiLCJhdXRvbWF0aW9uOmJvdC1hdXRob3JlZCIsImRlcGVuZGVuY3ktdHlwZTo6cGF0Y2giXX0=-->
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