Repository Public License
1<!--2ORIX Secure3File: docs/design/icon-design.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->78# Icon design910The icon is generated by code. `design/icon/concepts.py` draws the five concepts that were explored;11`design/icon/build.py` draws the production icon from one shared geometry and exports every asset. Nothing was12drawn by hand, so everything on this page can be regenerated and checked against the scripts.1314## The five concepts1516All five use the same violet gradient tile (`#A78BFA` → `#7C3AED` → `#4C1D95`), a white-to-lavender foreground17(`#FFFFFF` → `#E4DCFF`) and mint (`#34D399`) for the protected element. The contact sheet shows each at 180, 60 and1829 px with the Home Screen mask, on a light and on a dark wallpaper.19202122From left to right:2324| # | File (`design/icon/concepts/`) | Idea | Construction |25|---|---|---|---|26| 1 | `01-orix-o-shield.svg` | the ORIX ring holding a small solid shield | four arcs (centre-line radius 264, stroke 96) around a mint shield |27| 2 | `02-security-aperture.svg` | a security aperture: six iris blades closing on a hexagonal opening | six rotated blades of radius 300, a mint disc of radius 58 at the centre |28| 3 | `03-protective-ring.svg` | protective rings: the ORIX ring, a thin unbroken guard ring, what is protected at the centre | four arcs (radius 280, stroke 84), a mint circle (radius 150, stroke 34), a white core (radius 56) |29| 4 | `04-keyhole.svg` | minimal cryptographic symbol: the ring with a keyhole | four arcs (radius 264, stroke 96) around a white keyhole |30| 5 | `05-shield-ring.svg` | layered monogram: the four ORIX arcs drawn along a shield contour, protecting a core | a shield path stroked at 92 with a dash pattern (`pathLength=100`, dashes 19.5 / 5.5), a mint disc of radius 70 |3132## Evaluation3334Judged on the contact sheet above. Ratings are the designer's reading of the renders (● good, ◐ acceptable,35○ weak), not measurements.3637| Criterion | 1 Ring + shield | 2 Aperture | 3 Protective ring | 4 Keyhole | 5 Shield contour |38|---|---|---|---|---|---|39| Originality | ○ a shield in a ring is the stock security motif | ◐ unusual, but reads as a camera iris | ● no borrowed security symbol | ◐ a keyhole is a common lock motif | ○ renders as a plain shield outline |40| Recognisability | ◐ | ○ a white disc with a hexagon; no link to the family | ● ring, ring, dot | ● | ◐ generic |41| Small-size legibility (29 px) | ◐ the shield becomes a blob | ◐ a white disc; the blades disappear | ● three concentric shapes survive | ● | ● a simple outline |42| Geometric balance | ◐ the shield's point pulls the eye down | ● | ● fully radial, even gaps | ◐ the keyhole stem is bottom-heavy | ◐ |43| Brand consistency (ORIX ring) | ● | ○ the ring is gone | ● | ● | ○ the arcs were lost in rendering |44| Contrast | ● | ● | ● white and mint on violet | ● | ● |45| Home Screen appearance | ◐ | ◐ a large white mass, heavier than its neighbours | ● | ● | ◐ |46| App Store presentation | ◐ close to clip art at large size | ◐ suggests a camera app | ● distinct at large size | ◐ says "lock", "password" | ○ indistinguishable from other security apps |4748## Why concept 3, "protective ring"4950Concept 3 was chosen: the four-arc ORIX ring, an unbroken mint guard ring, and the protected core.5152- **It keeps the family ring intact** and adds meaning inside it, which is the family's rule: same ring, different53 centre.54- **The idea is in the geometry.** The outer ring has four gaps; the guard ring has none. The only closed shape in55 the mark is the one that protects, and it is the only mint element.56- **It claims nothing the app does not do.** No shield, padlock or check mark: the app assesses and explains, and its57 icon avoids the vocabulary of antivirus products for the same reason its text does58 (see [brand-guidelines.md](brand-guidelines.md)).59- **It survives small sizes.** Three concentric shapes with clear gaps remain distinct at 29 px.60- **It works without colour.** The structure reads in grayscale, which the tinted appearance requires.6162Why not the others:6364- **Concept 5** did not render as intended. The dashed stroke was meant to lay the four ORIX arcs along a shield65 contour; with the wide stroke and round caps the dashes merged, and the result reads as a generic solid shield66 outline with a dot — neither the family ring nor an original shape.67- **Concept 1** is a shield inside a ring: the closest of the five to clip art, and the shield loses its shape at68 small sizes.69- **Concept 2** loses the family ring altogether, and the blades merge into a white disc.70- **Concept 4**'s keyhole reads well at every size, but it says "lock" more than "assessment": it suggests a71 password manager or an app locker, which this app is not.7273## Geometry7475From `design/icon/build.py`, on a 1024 × 1024 canvas centred at (512, 512). The production geometry is concept 376slightly enlarged (ring radius 280 → 284, guard ring 150 → 152, core 56 → 58).7778| Element | Geometry |79|---|---|80| ORIX ring | four arcs centred at 45°, 135°, 225° and 315°, each spanning 52° (half-span 26°); centre-line radius 284, stroke 84, round caps. Outer diameter 652 = 64 % of the tile. |81| Guard ring | full circle, radius 152, stroke 34, no gap |82| Core | filled circle, radius 58 |8384Resulting clearances: 73 units between the inner edge of the ORIX ring (242) and the outer edge of the guard ring85(169), and 77 units between the inner edge of the guard ring (135) and the core (58) — two nearly equal bands of86background, which is what keeps the three shapes separate at small sizes.8788The in-app mark (`ORIXMark` in `Packages/ORIXDesign/Sources/ORIXDesign/Components.swift`) redraws the same figure in89a SwiftUI `Canvas`, scaled to fill its frame: ring radius 0.36 × side with stroke 0.105 × side and arcs from 19° to9071° in each quadrant, guard ring radius 0.19 × side with stroke 0.043 × side, core radius 0.072 × side.9192## Colours9394| | Default | Dark | Tinted |95|---|---|---|---|96| Background | linear gradient `#A78BFA` → `#7C3AED` (50 %) → `#4C1D95`, from (96, 0) to (928, 1024) | transparent | `#000000` |97| Glow | radial, mint `#34D399` at 30 % → 0 %, radius 250, behind the artwork | — | — |98| ORIX ring | vertical gradient `#FFFFFF` → `#E4DCFF` | diagonal gradient `#C4B5FD` → `#8B5CF6` | vertical gradient `#FFFFFF` → `#9A9A9A` |99| Guard ring | `#34D399` | `#34D399` | `#C8C8C8` |100| Core | `#FFFFFF` | `#F5F3FF` | `#FFFFFF` |101102## The three appearances103104105106| Appearance | File in `AppIcon.appiconset` | Format |107|---|---|---|108| Default | `AppIcon.png` | 1024 × 1024, opaque RGB (no alpha channel), sRGB profile embedded |109| Dark | `AppIcon-Dark.png` | 1024 × 1024, RGBA with a **transparent background**: the system supplies the dark backdrop; sRGB |110| Tinted | `AppIcon-Tinted.png` | 1024 × 1024, **grayscale** artwork on black (stored as RGB): the system applies the user's tint |111112Each appearance is a **single 1024 × 1024 asset** in the asset catalog (`idiom: universal`, `platform: ios`, with a113`luminosity` appearance of `dark` or `tinted` for the two variants). There are no per-size PNGs: the system derives114every size and applies the icon mask. The masters contain no rounded corners.115116In the illustration above, the dark backdrop and the violet tint are **simulated** by `build.py` (an approximation117of the system's dark backdrop, and the ORIX violet as the user's tint). On a device the backdrop and the tint are118the system's and the user's.119120## Sizes121122123124The default icon at 180, 120, 60 and 29 px with the Home Screen mask applied by `design/icon/contact.py`125(a rounded rectangle with a corner radius of 22.37 % of the side, an approximation of the system shape used for126these previews only).127128## Files129130| Path | Content |131|---|---|132| `design/icon/concepts.py` | the five concepts and the contact sheet |133| `design/icon/build.py` | production masters and every exported asset |134| `design/icon/contact.py` | mask, wallpaper and contact-sheet helpers |135| `design/icon/concepts/*.svg` | the five concept SVGs |136| `design/icon/master/orix-secure-icon.svg`, `-dark.svg`, `-tinted.svg` | SVG masters of the three appearances |137| `design/icon/master/orix-secure-mark.svg` | single-colour template mark |138| `design/icon/render/` | intermediate PNG renders (git-ignored) |139| `App/Resources/Assets.xcassets/AppIcon.appiconset/` | the three 1024 px icons and `Contents.json` |140| `App/Resources/Assets.xcassets/Mark.imageset/Mark.svg` | in-app template mark, vector preserved |141| `App/Resources/Assets.xcassets/LaunchMark.imageset/` | launch mark, 96 pt at 1×, 2×, 3×, from the dark-appearance artwork |142| `App/Resources/Assets.xcassets/LaunchBackground.colorset`, `AccentColor.colorset` | `#F4F5FA` / `#0A0D18` and `#7C3AED` / `#A78BFA` |143| `docs/assets/logo.svg`, `icon-1024.png`, `icon-256.png` | repository artwork |144| `docs/assets/concepts.png`, `icon-appearances.png`, `icon-sizes.png` | the illustrations on this page |145146All SVG and asset files written by the scripts are generated: change the script, not the output.147148## Regenerating149150Requirements: Python 3 with Pillow, and `rsvg-convert` (`brew install librsvg`).151152```bash153python3 design/icon/build.py # masters, AppIcon set, mark, launch mark, colour sets, docs/assets icon art154python3 design/icon/concepts.py # the five concepts and docs/assets/concepts.png155```156157Both print `ok`. `build.py` rewrites the asset catalog entries listed above, so rebuild the app afterwards. To158change the icon, edit the constants at the top of `build.py` (`R`, `W`, `HALF`, `GR`, `GW`, `CORE`) or the colour159stops, and keep `ORIXMark` in `Components.swift` in step with the new proportions.160