Repository Public
1<!--2ORIX Docs3File: docs/design/icon-design.md4Description: The five icon concepts, their evaluation, the decision, and how the shipped icon is produced.5Author: Simon-Pierre Boucher6Contact: contact@spboucher.ai7-->8# Icon design910The ORIX Docs icon is original artwork drawn in code with Core Graphics (`design/icon/make-icon.swift`). It uses no external image, font file or template, and it does not imitate the icons of Microsoft Word or Apple Pages. Five concepts were drawn on the shared ORIX plate ([brand-guidelines.md](brand-guidelines.md)) and compared at three sizes.11121314The contact sheet above (`design/icon/concepts-sheet.png`, copied to `docs/assets/icon-concepts.png`) shows each concept at 280 px, 64 px and 32 px on a light grey background.1516## The five concepts1718All five sit on the same plate: a dark ink rounded square with a blue-violet glow from the top-left corner.1920| # | File | What is drawn |21|---|---|---|22| 1 | [`concept-1-o-page.png`](../../design/icon/concept-1-o-page.png) | **O + page.** The indigo gradient ring, left of centre and open on its right side; a white sheet with a folded top-right corner overlaps the opening. On the sheet: one short solid indigo bar (a heading), five pale indigo bars of uneven length (lines of text), and a small amber mark after the last, shorter line (the caret). |23| 2 | [`concept-2-monogram.png`](../../design/icon/concept-2-monogram.png) | **Monogram.** A large white-to-lavender letter O with strong contrast between thick sides and thin top and bottom (an ellipse with a narrow elliptical counter), a violet pilcrow (¶, Baskerville) standing in the counter. The plate's glow is more violet. |24| 3 | [`concept-3-text-lines.png`](../../design/icon/concept-3-text-lines.png) | **Text lines.** The ring, centred and open on the right, crossed by five white bars of different lengths set flush left, like a ragged-right paragraph running out of the ring. |25| 4 | [`concept-4-open-book.png`](../../design/icon/concept-4-open-book.png) | **Open book.** A thinner closed ring shading from light blue to indigo; inside it, an open book seen from the front: two white pages with curved top and bottom edges and an indigo spine. The glow is bluer. |26| 5 | [`concept-5-layers.png`](../../design/icon/concept-5-layers.png) | **Layers.** Three sheets fanned out: two translucent lavender sheets rotated behind a white sheet with a folded corner, which carries a small closed ring. |2728## Evaluation2930Scores from 1 (weak) to 5 (strong). They are a design judgement made on the contact sheet, not a measurement; the small-size column was judged on the 64 px and 32 px renderings.3132| Criterion | 1 O + page | 2 Monogram | 3 Text lines | 4 Open book | 5 Layers |33|---|---|---|---|---|---|34| Originality | 4 — the ring opened by a page is specific to this app | 3 — letter-in-a-tile is a common pattern | 4 — unusual, abstract | 2 — an open book is a stock symbol for reading | 3 — stacked sheets are common for document tools |35| Recognisability ("a writing app") | 5 — page, lines and caret say it at once | 3 — the pilcrow speaks to typographers only | 3 — reads as "text" or as a menu | 2 — reads as a reader or a library | 4 — reads as "documents", less as "writing" |36| Small-size legibility | 4 — ring and page hold at 32 px; the lines merge and the caret disappears | 5 — a single bold shape | 3 — bars and ring blend at 32 px | 4 — ring and book stay clear | 3 — the back sheets and the small ring are lost |37| Geometric balance | 4 — the page sits right of centre and answers the ring on the left | 5 — symmetric | 3 — bars overflow the ring to the right | 5 — symmetric | 3 — the fan leans left |38| Brand consistency (plate, ring, accent pair) | 5 — plate, ring, indigo and the amber accent | 2 — no ring; the O is a letter, not the ORIX ring | 4 — plate and ring, no amber | 3 — ring recoloured towards blue, no amber | 3 — the ring is reduced to a detail |39| Dock and Finder appearance | 4 — the white page gives contrast on dark and light backgrounds | 4 — strong, but anonymous among letter icons | 3 — low contrast between ring and bars | 4 — clear silhouette | 3 — busy |40| **Total (of 30)** | **26** | **22** | **20** | **20** | **19** |4142## Decision4344**Concept 1, "O + page", is the shipped icon.** It is the only concept that keeps the whole family signature (plate, ring, both accent colours) while showing the subject of the application without needing a caption. Its weakness is the fine detail on the page at 16–32 px, which is accepted: at those sizes the icon is carried by the ring-and-page silhouette.4546`finalIcon(_:)` in `make-icon.swift` calls `conceptOPage(_:)` directly, and `design/icon/orix-docs-icon-1024.png` is byte-identical to `concept-1-o-page.png` and to `icon_1024.png` in the asset catalogue.47484950## How it is produced5152```sh53cd design/icon54swift make-icon.swift .55```5657The script draws on a 1024 × 1024 canvas with a transparent background and writes, into the output directory: the five `concept-*.png`, `orix-docs-icon-1024.png` and `concepts-sheet.png`. Its building blocks:5859| Function | Draws |60|---|---|61| `plate(_:glow:)` | The 824 × 824 rounded square (corner radius 186) inset 100 px, its drop shadow, the ink gradient, the radial glow and a 3 px edge highlight. |62| `ring(_:center:radius:width:gaps:colors:)` | A stroked circle, or arcs between the given gaps with round caps, filled with a diagonal gradient. |63| `page(_:_:fold:radius:top:bottom:shadow:)` | A rounded sheet with a folded top-right corner, a white-to-lavender gradient and a shadow. |64| `roundedBar(_:_:_:)` | The pill-shaped bars used for text lines and the caret. |6566The application icon set is `App/Resources/Assets.xcassets/AppIcon.appiconset`, with seven PNG files covering the ten macOS slots:6768| File | Pixels | Slots |69|---|---|---|70| `icon_16.png` | 16 | 16 pt @1x |71| `icon_32.png` | 32 | 16 pt @2x, 32 pt @1x |72| `icon_64.png` | 64 | 32 pt @2x |73| `icon_128.png` | 128 | 128 pt @1x |74| `icon_256.png` | 256 | 128 pt @2x, 256 pt @1x |75| `icon_512.png` | 512 | 256 pt @2x, 512 pt @1x |76| `icon_1024.png` | 1024 | 512 pt @2x |7778`make-icon.swift` produces the 1024 px master only. The smaller files are reductions of it, produced by `Scripts/icons.sh` (`sips`), which also refreshes the documentation copies. `docs/assets/orix-docs-icon-256.png` is the 256 px version used in the documentation.7980## Notes on the artwork8182* The margins around the plate (100 px of 1024) leave room for the shadow, as macOS icons of this shape do.83* The caret is drawn with `roundedBar`, whose corner radius is half the bar's height; on a bar that is taller than wide this gives an elongated oval rather than a straight bar.84* The plate's linear gradient is drawn without extending before its start point; with the radial glow on top, a slightly different tone is visible in the extreme top-left corner of the plate at full size.85