Repository Public License
1<!--2ORIX Monitor3File: docs/design/icon-design.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->78# Icon design9101112The ORIX Monitor icon was designed in code. Five concepts were drawn with Core Graphics by `Scripts/tools/make-icon.swift`, rendered side by side at Dock size and at small sizes, compared against a fixed list of criteria, and one was chosen. This document records the process, the concepts, the evaluation and the reasons.1314**Decision:** concept 1 — the ORIX "O" crossed by a pulse — because it carries the brand letter, stays legible at 16 px and matches the menu-bar glyph.1516## Process17181. **Common plate.** All concepts are drawn on the same background so that only the symbol differs.192. **Five concepts** exploring different metaphors for "system monitor".203. **Contact sheet.** `make-icon concepts <dir>` writes each concept at 1024 px and a sheet that shows every concept large on a dark strip and at 128, 64, 32 and 16 pt on a light strip.214. **Evaluation** against seven criteria (below).225. **Export.** `make-icon export <n> <dir>` renders the chosen concept at 16, 32, 64, 128, 256, 512 and 1024 px.23242526The working files are in `design/icon/`: `concept-1.png` … `concept-5.png`, `concepts-sheet.png` and `orix-monitor-icon-1024.png`.2728### The generator2930```31swift Scripts/tools/make-icon.swift concepts <dir> # five 1024 px concepts + contact sheet32swift Scripts/tools/make-icon.swift export <n> <dir> # concept n as icon_<size>.png33```3435Drawing the icon in code has practical consequences: every size is rendered from vectors at its own resolution rather than downscaled from a bitmap; the geometry is reviewable in a diff; and the colours are the same hex constants as the rest of the product.3637## The plate3839Shared by all five concepts (`plate(_:)`):4041| Property | Value |42|---|---|43| Canvas | 1024 × 1024 px |44| Plate | 824 × 824 px, centred (100 px margin) — the macOS icon grid |45| Corner radius | 186 px |46| Drop shadow | offset (0, −10), blur 24, black at 35 % |47| Fill | Vertical gradient `#1D2440` (top) → `#0B0E1B` (bottom) |48| Glow | Radial cyan `#22D3EE` at 20 % → 0 %, centred upper left (300, 800), radius 620 |49| Edge | 4 px inner stroke, white at 10 % |5051Symbol colours: cyan `#22D3EE`, indigo `#6366F1`, violet `#A78BFA`. Gradient strokes run diagonally from upper left (220, 780) to lower right (800, 240).5253## The five concepts5455| # | Concept | Construction |56|---|---|---|57| 1 | **ORIX "O" crossed by a system pulse** | A ring of radius 236 px and stroke 62 px, drawn as two arcs that leave openings at the left and right (each arc stops 0.2 rad short of the horizontal), stroked cyan → indigo. A heartbeat trace runs through the openings from x = 170 to 854, amplitude 150 px, stroke 44 px, white → `#DFF7FF`. |58| 2 | **Geometric performance waveform** | Eight rounded vertical bars (44 px wide, 76 px pitch) of heights 130–520 px, centred vertically, filled with the cyan → indigo gradient. |59| 3 | **Apple-Silicon-inspired chip holding a pulse** | A 400 px rounded square (radius 84, stroke 40) with four pins on each side in indigo, and a small pulse (amplitude 96, stroke 32) inside. |60| 4 | **Precision telemetry ring** | Three concentric gauge tracks (radii 268, 196, 124; stroke 46) at 82 %, 58 % and 36 % sweep, each with its own gradient, and a white centre dot. |61| 5 | **Abstract system activity** | Two overlapping smooth traces (strokes 44 and 30) with a cyan gradient area under the upper one. |6263## Evaluation criteria6465| Criterion | Question |66|---|---|67| Originality | Does it avoid looking like an existing system-monitor or generic "chart" icon? |68| Recognisability | Can someone tell what the app does, and tell the icon apart after seeing it once? |69| Small-size readability | Is the shape still intact at 16 and 32 px, where the Finder list view and Spotlight show it? |70| Geometric balance | Is the mass centred and stable on the plate, without a visual lean? |71| Brand consistency | Does it carry the ORIX identity and relate to the other surfaces of the product? |72| Contrast | Does the symbol separate cleanly from the plate, and the plate from light and dark backgrounds? |73| Dock / Finder appearance | Does it sit well next to other macOS icons at 128 px, with the expected plate shape and weight? |7475## Scores7677Scores are a **qualitative design assessment** on a 1–5 scale (5 = best), made by inspecting the contact sheet and the geometry in the generator. They are judgements, not measurements; no legibility or contrast metric was computed.7879| Criterion | 1 · O + pulse | 2 · Waveform | 3 · Chip | 4 · Rings | 5 · Traces |80|---|:-:|:-:|:-:|:-:|:-:|81| Originality | 4 | 2 | 2 | 3 | 3 |82| Recognisability | 5 | 3 | 4 | 3 | 3 |83| Small-size readability | 5 | 3 | 2 | 3 | 2 |84| Geometric balance | 5 | 4 | 4 | 5 | 3 |85| Brand consistency | 5 | 2 | 2 | 3 | 3 |86| Contrast | 5 | 4 | 3 | 4 | 3 |87| Dock / Finder appearance | 5 | 4 | 4 | 4 | 3 |88| **Total (of 35)** | **34** | **22** | **21** | **25** | **20** |8990## Reasoning9192### Concept 1 — ORIX "O" crossed by a pulse (chosen)9394- **Brand.** It is the only concept that contains the brand letter. The ring reads as the "O" of ORIX; the pulse says what this member of the family does. The cyan → indigo gradient is the product accent over the family colour.95- **Small sizes.** The symbol reduces to two elements with thick strokes: a 62 px ring and a 44 px trace on a 1024 px canvas, about 1 px and 0.7 px at 16 px. A circle with a zigzag through it survives that reduction; the openings in the ring keep the trace from merging with it.96- **Contrast.** The pulse is near-white on a dark plate — the highest contrast available — while the ring carries the colour. The two elements are separated by both hue and value.97- **Balance.** Radially symmetric ring, horizontally centred trace; the pulse's upward and downward peaks are of similar magnitude, so the mass stays on the centre line.98- **System coherence.** The menu-bar status item draws the same idea in monochrome (a ring cut by a pulse, `MenuBarRenderer`), so the app is recognisable in the Dock, in Finder and in the menu bar. The tagline — "Understand Every Pulse of Your Mac." — names the same image.99- **Weakness.** A heartbeat trace is a familiar motif for monitoring tools in general; originality comes from combining it with the letterform rather than from the trace itself. Hence 4, not 5.100101### Concept 2 — Geometric performance waveform102103Clean, well balanced and high in contrast, but it reads as "audio" or "equaliser" at least as readily as "system performance", and bar-chart icons are common. It has no link to the ORIX name. At 16 px eight bars with 32 px gaps (half a pixel) blur into a block.104105### Concept 3 — Apple-Silicon-inspired chip106107Immediately says "hardware", which helps recognisability, but a chip with pins is among the most used metaphors for system utilities, so originality is low. Sixteen pins and an inner pulse are too much detail for 16 px: the pins disappear and the pulse closes up. The solid indigo pins are also the lowest-contrast element on a navy plate.108109### Concept 4 — Precision telemetry ring110111The most balanced composition after concept 1 and a strong Dock presence. However, three concentric progress rings strongly evoke activity and fitness tracking rather than a computer, and at small sizes the three rings merge into one thick band. The outer ring loosely echoes an "O", which is why it scores above concepts 2 and 3 for brand consistency, but the reference is accidental rather than legible.112113### Concept 5 — Abstract system activity114115Closest to what the app's charts actually look like, and attractive at large sizes. It is the weakest at small sizes — two thin curved lines and a faint gradient area do not survive — and the weakest in balance, since the traces rise to the right and the filled area weights the lower half. It could be the icon of any charting or analytics product.116117## Chosen icon — specification118119| Element | Geometry (1024 px canvas) | Colour |120|---|---|---|121| Ring | Centre (512, 512), radius 236, stroke 62, round caps; two arcs leaving a gap of 0.4 rad on each side | Linear gradient `#22D3EE` → `#6366F1`, upper left to lower right |122| Pulse | From (170, 512) to (854, 512), amplitude 150, stroke 44, round caps and joins; vertices at 30 %, 40 % (+0.95), 54 % (−1.0), 64 % (+0.42), 71 % and 100 % of the width | Linear gradient `#FFFFFF` → `#DFF7FF` |123| Plate | As described above | `#1D2440` → `#0B0E1B`, cyan glow |124125The rendered PNG files for the app icon live in the asset catalogue's `AppIcon` set (`App/Resources/Assets.xcassets/AppIcon.appiconset`), which `project.yml` references through `ASSETCATALOG_COMPILER_APPICON_NAME: AppIcon`.126127## Limitations and open points128129- **The scores are judgements.** No user testing, no quantitative legibility test and no computed contrast ratio back them.130- **One appearance.** The icon has a single dark plate; there is no light, tinted or monochrome variant of the app icon. (The menu-bar glyph is the monochrome rendition of the mark.)131- **No hand-tuned small sizes.** The 16 and 32 px images are the same vector geometry rendered at that resolution with high-quality interpolation; strokes are not individually snapped to the pixel grid.132- **Only concept 1 is exported.** `make-icon export` writes the `icon_<size>.png` files; the README logo is the 512 px render copied to `docs/assets/icon.png`.133- **The plate is drawn manually** (rounded rectangle with a 186 px corner radius) rather than taken from an Apple template, so its corner curve is an approximation of the system icon shape.134