Some checks failed
CI / Build & test (Node 24) (push) Has been cancelled
CI / Pack & boot smoke (Node 22) (push) Has been cancelled
CI / No em/en dashes (push) Has been cancelled
CI / Build & test (Node 22) (push) Has been cancelled
Deploy site (production) / build-and-deploy (push) Successful in 20s
Remplace les 547 tirets cadratins (U+2014) et demi-cadratins (U+2013) des fichiers versionnés par la ponctuation contextuelle adaptée (point médian, deux-points, virgule, parenthèses ; tiret simple pour les plages), sur 122 fichiers (appli, vitrine, doc, tests, workflows, scripts). Ajoute le job CI « lint-dashes » (git grep -P) qui échoue si un tiret cadratin/demi-cadratin réapparaît, hors logo binaire et captures brutes du terminal (fidélité des fixtures de détection de dialogue).
43 lines
2.0 KiB
Markdown
43 lines
2.0 KiB
Markdown
# Brand assets
|
||
|
||
Logo and icon assets for Arboretum. Source artwork is a neon circuit-tree (green
|
||
branches, cyan session nodes, a `>_` prompt at the base) on a dark background.
|
||
|
||
| File | Use |
|
||
| --- | --- |
|
||
| `arboretum-logo-source.png` | Master artwork (opaque dark background). Keep; everything else derives from it. |
|
||
| `arboretum-logo.png` | Full logo, **transparent**. Best on dark surfaces (the wordmark is light). |
|
||
| `arboretum-logo-on-dark.png` | Full logo on the app background `#09090b`. Safe on any theme, used in the README. |
|
||
| `arboretum-mark.png` | Square, **transparent**, tree only (no wordmark). Ideal **Gitea repo avatar**, reads on both light and dark. |
|
||
|
||
The transparent versions are extracted by luminance (alpha ∝ brightness), the clean
|
||
way to lift glow-on-black artwork: the dark background becomes fully transparent, the
|
||
bright strokes stay opaque, and the glow halos stay semi-transparent so the logo sits
|
||
correctly on any dark surface.
|
||
|
||
## Gitea
|
||
|
||
Upload `arboretum-mark.png` as the repository avatar (Settings → uploads a square image;
|
||
the tree-only mark stays legible at small sizes and works on Gitea's light and dark themes).
|
||
Use `arboretum-logo.png` (transparent) on dark pages, or `arboretum-logo-on-dark.png`
|
||
when the surrounding background might be light.
|
||
|
||
## App / favicon assets
|
||
|
||
The web-facing assets live in `packages/web/public/` and are wired into the SPA:
|
||
|
||
- `icon.svg`: scalable favicon, redrawn to match the brand (vector, glow, `>_`).
|
||
- `icon-192.png` / `icon-512.png`: maskable PWA icons (tree on `#09090b`, content in the safe zone).
|
||
- `apple-touch-icon.png`: iOS home-screen icon (180×180).
|
||
- `favicon.ico`: multi-size favicon (16/32/48), transparent.
|
||
- `logo.png`: transparent full logo for in-app use.
|
||
|
||
## Regenerate
|
||
|
||
```bash
|
||
python3 brand/build-assets.py # uses brand/arboretum-logo-source.png
|
||
python3 brand/build-assets.py other.png # or pass another source
|
||
```
|
||
|
||
Requires Python with Pillow + numpy. Writes both `brand/` and `packages/web/public/`.
|