# Ely Office icons

One schema for all eight apps, after the Papirus icon theme: each app is one large flat object on Papirus's 192-unit grid (a page, a board, an envelope, a terminal). The body is one saturated colour; a folded corner is a lighter tint of it; content is white, with at most one accent colour. Each body and its content cast Papirus's soft shadow (the shape, 4 or 2 units down, blurred, 20 % black). No gradients, outlines or glass.

| App | Object | Colour | Accent |
| --- | --- | --- | --- |
| ElyDoc | page of lines | `#3D7FE5` | |
| ElyTable | page with a grid | `#2E9E5B` | selected cell `#FFD54F` |
| ElyShow | chart board on a stand | `#F07B2A` | pie `#5D7FC9` |
| ElyPDF | page with a picture | `#E0344F` | |
| ElyMail | envelope | `#1E8FE0` | |
| ElyTree | branch with commits | `#7E57C2` | merge commit `#F2A900` |
| ElyMark | notepad with M and arrow | `#ECECEC`, `#3E4A5C` | arrow `#F2A900` |
| ElyAgent | terminal prompt | `#4F4F4F` | spark `#FF6B8B` |

## Files

- `packaging/icons/masters.py` writes every SVG master. Change the design there, never in the SVGs.
- `<slug>.svg` is the shapeless master for Linux and Windows: the object alone on a transparent background.
- `<slug>-macos.svg` is the macOS master: the same object at 86 % on a light Apple squircle (an 824/1024 body drawn as a superellipse with n = 5).
- `<slug>-small.svg` and `<slug>-small-macos.svg` are the cut for sizes under 48 px: no shadows, no small details.
- `<slug>.icns`, `<slug>.png` (512 px) and `<slug>.ico` (16 to 256 px) are rendered by `packaging/icons/build.sh`. Never edit them by hand. `tests/scripts/icons.sh` fails when a rendered file is older than its master.

## Rules

- Objects fill Papirus's frame: a page is 128 by 160 units, a landscape object 160 wide.
- Never put a container behind a shapeless icon, and never recolour one.
- A new app takes an object, a body colour unlike the others, and at most one accent.