SPB Git

Repository Public

icon-design.md 9.4 KB

# Icon design

The ORIX Sheet icon is generated by code, not drawn in an editor: design/icon/make-icons.swift (212 lines, AppKit + CoreGraphics) draws five concepts, the final 1024 px master, a contact sheet and the ten PNG sizes of the macOS asset catalog.

Related: brand guidelines, design system, distribution (the DMG background reuses the same plate).

# What is and is not recorded

The brief for this document asks for the evaluation of the five concepts against six criteria (originality, recognizability, balance, small-size legibility, family consistency, contrast). No scores, ranking or written evaluation exist in the repository. What exists is:

  • the generator script, whose comments state the idea of each concept and the reason for the final choice in one sentence ("Final — refinement of concept 1: thicker ring opened by the sheet's row/column axes, larger cells, the active cell carries the selection handle. Reads at 16 px as 'ring + bright square'.");
  • the rendered images, including a contact sheet built for the comparison: each concept at 300 px and, underneath, at 64, 32 and 16 px.

The sections below therefore describe what the script draws and what the images show. The per-criterion table is an examination of those images made for this document on 2026-11-21; it is a qualitative reading, not a record of the original decision, and no numeric score is given.

# The contact sheet

Five concepts and the final icon, each at 300 px with 64, 32 and 16 px renderings underneath

Left to right: concepts 1 to 5, then the final icon. The file is a copy of design/icon/concepts-sheet.png (1840 × 450 px, background #F4F5FA, the light canvas token).

# Common construction

Every concept sits on the same plate (plate() in the script):

Element Value
Canvas 1024 × 1024 px, sRGB, transparent outside the plate
Plate 824 × 824 px rounded square centred in the canvas, corner radius 186 px
Plate fill vertical gradient #1B2A4A (top) → #0B0F1E (bottom) over a #0B1020 base
Glow radial, centre (330, 800), radius 560 px, 75 % → 0 % opacity; colour #1E5A78 (concepts 1, 3, 4, final), #2A3F8A (concept 2), #1E6A78 (concept 5)
Drop shadow offset 10 px down, blur 24 px, black at 35 %
Edge 3 px white stroke at 10 %
Brand gradient #22D3EE → #3B9BF5 (at 55 %) → #6366F1, top-left to bottom-right of the shape's bounding box

Source: design/icon/make-icons.swift (plate, brand).

#22D3EE is the dark-mode accent token of the application; the plate colours are icon-only and are not tokens (see design system).

# The five concepts

# File Idea (script comment) What is drawn
1 concept-1-ring-sheet.png ORIX "O" whose counter is a 3×3 sheet; one cell is the active cell gradient ring 536 px across, 62 px thick; nine 78 px cells with 16 px gaps; centre cell solid white, top row at 42 % and the others at 26 % of #EAF6FF
2 concept-2-data-matrix.png abstract data matrix: 5×5 dots with a diagonal intensity ramp twenty-five 92 px rounded squares, opacity rising from 18 % (bottom-left) to 100 % (top-right)
3 concept-3-precision-table.png precision table: header band, hairline rules and measurement ticks translucent table with a gradient header band 96 px high, three horizontal and two vertical 6 px rules, thirteen cyan ruler ticks under the table
4 concept-4-chart-cells.png chart + grid monogram: rising bars made of cells 4×4 grid of 112 px cells; columns filled to heights 1, 2, 3, 4 with the gradient, the rest at 8 % white
5 concept-5-layered-sheets.png layered sheets inside the ORIX ring gradient ring 552 px across, 46 px thick; three stacked white sheets at 22 %, 48 % and 100 % opacity, the front one ruled into cells

Source: design/icon/make-icons.swift (concept1 … concept5); files in design/icon/, each 512 × 512 px.

# Reading of the images against the six criteria

Qualitative observations from the contact sheet. "Small sizes" refers to the 64 / 32 / 16 px row.

Criterion 1 Ring + sheet 2 Data matrix 3 Precision table 4 Chart cells 5 Layered sheets
Originality ring and grid combined in one mark a plain dot matrix; nothing ties it to this product a literal table; the ruler ticks are the only distinctive element a familiar "bars" chart motif built from cells ring plus a document stack; the stack is a common motif
Recognizability as a spreadsheet the 3×3 grid with one selected cell reads as a sheet reads as a generic grid or keypad the most literal: header, rows, columns reads as a chart first, a sheet second the ruled front sheet reads as a document or table
Balance radially symmetric, centred uniform texture, weight shifts to the top-right with the opacity ramp top-heavy (bright header band), ticks close to the bottom edge weight on the right and bottom (staircase) stack offset down-left inside a centred ring
Small-size legibility at 16 px a ring with a bright centre remains at 16 px the dots merge into a dark square rules and ticks disappear at 16 px; the header band remains as a line the staircase survives at 32 px, is faint at 16 px ring and white block remain; the ruling is lost
Family consistency uses the ORIX "O" ring and the brand gradient brand gradient only, no ring gradient only in the header band brand gradient only, no ring uses the ring and gradient
Contrast white active cell on navy; pale cells are low-contrast by design lower-left dots nearly merge with the plate 6 px half-opacity rules are faint on the translucent table filled cells strong; empty cells at 8 % barely visible solid white sheet has the strongest contrast of the five

Source: visual examination of design/icon/concepts-sheet.png on 2026-11-21. No measurement (contrast ratio, legibility test with users) was made, and none is recorded in the repository.

What the images support: the two ring concepts (1 and 5) are the only ones that keep a recognisable silhouette in the 16 px rendering, and of those two, concept 1 keeps the spreadsheet idea (grid plus active cell) inside the ring rather than a document stack. This agrees with the script's own comment that the final is a refinement of concept 1 chosen to read at 16 px as "ring + bright square". Whether the six criteria were weighed in this way when the choice was made is not documented.

# The final icon

Final ORIX Sheet icon, 1024 px master

finalIcon() changes concept 1 as follows:

Property Concept 1 Final
Ring outer diameter 536 px 564 px
Ring thickness 62 px 70 px
Cell side / gap 78 px / 16 px 84 px / 15 px
Cell corner radius 18 px 19 px
Surrounding cells #EAF6FF, top row 42 %, others 26 % #DDF3FF, top row and left column 40 %, others 22 %
Active cell white white with a cyan glow (#22D3EE at 85 %, blur 34 px)
Selection handle none 30 px cyan square (#22D3EE, radius 8) on a 42 px #101A30 backing, at the bottom-right corner of the active cell

Source: design/icon/make-icons.swift (concept1, finalIcon).

The brighter top row and left column stand for the header row and header column of a sheet; the handle is the fill handle of the selected cell. In the script comment the ring is described as "opened by the sheet's row/column axes"; the drawing code does not cut the ring — it is a closed annulus (two ellipses with even-odd clipping), and the rendered master shows a closed ring. The comment and the code disagree on that point.

# Generated files

text
swift design/icon/make-icons.swift design/icon

writes, into the directory given as argument:

Output Size
concept-1-…png to concept-5-…png 512 × 512 px (drawn at 1024, downsampled with high interpolation)
orix-sheet-icon-1024.png 1024 × 1024 px master
concepts-sheet.png 1840 × 450 px contact sheet
AppIcon.appiconset/ icon_16x16.png … icon_512x512@2x.png (16, 32, 128, 256, 512 pt at 1x and 2x) and Contents.json

Source: design/icon/make-icons.swift; pixel sizes confirmed with sips -g pixelWidth -g pixelHeight.

Facts about the generated set:

  • All ten sizes are downsampled from the single 1024 px master. There is no size-specific artwork: the 16 px icon is the full drawing scaled down, not a simplified variant.
  • The asset catalog used by the build is App/Resources/Assets.xcassets/AppIcon.appiconset. The script writes to design/icon/AppIcon.appiconset; the copy into the app's catalog is a manual step that the script does not perform. On 2026-11-21 the two sets are byte-identical for the files compared (cmp on icon_16x16.png and on the 1024 px master vs icon_512x512@2x.png).
  • The same icon is declared as the document icon of .orixsheet files (UTTypeIconFile = AppIcon in App/Resources/Info.plist); there is no separate document icon.
  • The script is deterministic (no random input); re-running it regenerates every file.

# Not done

  • No dark/tinted/clear icon variants for newer macOS icon styles, no .icon (Icon Composer) file.
  • No monochrome or template version for menus or the toolbar.
  • No measured contrast for the icon and no legibility test beyond the contact sheet.
Files main
Menu

Theme