Raven Scott
b720e7e68f
Release rolling / release (push) Has been cancelled
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.
93 lines
3.1 KiB
Markdown
93 lines
3.1 KiB
Markdown
# 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 |
|
|
|
|
```html
|
|
<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`):
|
|
```js
|
|
icon: path.join(__dirname, 'build', 'icon') // resolves .icns / .ico / .png per platform
|
|
```
|
|
|
|
macOS .icns (on a Mac):
|
|
```bash
|
|
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
|