Raven Scott
b720e7e68f
Copy runtime logos/favicons into assets/ and package icons into build/, then use them for the titlebar, favicons, dock/window icons, and docs so packaging and the UI no longer rely on placeholder marks.
PearDock Branding Package v1.0.1
Clean assets built directly from your original transparent PNG.
No background removal, no color-keying, no artifacts. Original alpha anti-aliasing preserved exactly.
Source: the clean Gemini-generated logo you provided (RGBA, pure transparent black bg).
Critical Rule
Never re-process the master logo with background removal tools.
The masters in logo/ already have perfect transparency. Just resize with high-quality filters (LANCZOS / Mitchell).
Structure
logo/
peardock-icon-master.png # Clean square icon (original alpha)
peardock-icon-{16..2048}.png # All standard sizes
peardock-icon-mono.png
peardock-icon-teal.png
peardock-icon-dark.png / -light.png
peardock-logo-full-transparent.png
peardock-logo-full-1200.png / -800.png
peardock-logo-dark.png / -light.png
peardock-wordmark.svg + -dark.svg
source-original.png # Exact file you gave me
favicons/ # ico + all PWA sizes + webmanifest + browserconfig
app-icons/ # electron/ linux/ windows/ macos.iconset/ store icons
website/ # og-image, twitter-card, header-banner, hero-bgs, logos
social/ # avatars + circular + banner
brand-assets/ # colors.css (matches ui/styles.css) + brand-tokens.json
docs/ # PearDock-Brand-Guidelines.pdf (clean 5-page brand book)
Color Tokens (exact match to current CSS)
| Token | Hex | Role |
|---|---|---|
--bg-primary |
#0f1117 |
Main bg |
--accent-primary |
#2dd4bf |
Teal CTA / active |
--accent-secondary |
#14b8a6 |
Hover |
--text-primary |
#f4f7fb |
Body text |
Full list in brand-assets/colors.css and brand-tokens.json.
Drop-in Usage
This package is the source of truth. Runtime copies live in the app tree:
| Destination | Contents |
|---|---|
../build/icon.{png,icns,ico} |
Electron Forge / packager icons |
../assets/logo/ |
Titlebar + README logos |
../assets/favicons/ |
Favicons + webmanifest |
../assets/brand/ |
colors.css + brand-tokens.json |
<link rel="icon" href="assets/favicons/favicon.ico" sizes="any">
<link rel="apple-touch-icon" href="assets/favicons/apple-touch-icon.png">
<link rel="manifest" href="assets/favicons/site.webmanifest">
<meta name="theme-color" content="#2dd4bf">
Electron Forge (forge.config.cjs):
icon: path.join(__dirname, 'build', 'icon') // resolves .icns / .ico / .png per platform
macOS .icns (on a Mac):
cd app-icons/macos
iconutil -c icns peardock.iconset -o ../../build/icon.icns
Quality Guarantee
- Master icon & full logo cropped from your original PNG with zero color keying
- All sizes are pure high-quality resizes (PIL LANCZOS / ImageMagick)
- Alpha channel fully preserved (soft edges, no fringing, no matte)
- Dark/light composites are simple pastes onto solid color — no reprocessing
If any size ever looks soft, regenerate from logo/peardock-icon-master.png or logo/peardock-logo-full-transparent.png only.
© 2026 snxraven — Apache-2.0
Repo: https://git.ssh.surf/snxraven/peardock