Brand guidelines
Short and concrete: what makes ORIX Docs recognisably an ORIX application, and where each trait lives in the repository. Tokens and components are in design-system.md; the icon's history is in icon-design.md.
Name and tagline
- Name: ORIX Docs — "ORIX" in capitals, "Docs" capitalised, one space. Bundle display name
ORIX Docs(project.yml). - Tagline: ORIX Docs — Write Without Limits. (drawn on the disk-image background by
design/dmg/make-background.swift) - Document type: "ORIX Docs Document", extension
.orixdoc.
The three family traits
| Trait | What it is | Where |
|---|---|---|
| The plate | A deep ink rounded square (#1B1F3B to #0B0D1A) with a soft glow in the top-left corner and a faint light edge. The common ground of every ORIX icon. |
plate(_:glow:) in design/icon/make-icon.swift |
| The ring | The ORIX "O": a thick ring with a diagonal gradient (#8B7BFF → #6366F1 → #4F46E5), which an application may open or cross with its own subject. In ORIX Docs it opens on the right where the page passes through it. |
ring(_:center:radius:width:gaps:colors:) |
| The accent pair | Each ORIX app brings two colours. ORIX Docs: ink indigo #4F46E5 and page amber #F59E0B. |
Indigo: ORIX.Palette.accent, the asset catalogue's AccentColor, the default shape stroke, the "ORIX" document theme. Amber: the caret in the icon. |
The accent pair in the interface
| Light appearance | Dark appearance | |
|---|---|---|
Indigo (accent) |
#4F46E5 |
#818CF8 |
Amber (secondary) |
#D97706 |
#FBBF24 |
The brand amber #F59E0B is the icon's value. The interface token secondary uses a darker amber on light backgrounds and a lighter one on dark backgrounds so that it stays readable as text; it is the same hue family, not a different colour.
Indigo carries selection and state (selected mode, active toggle, caret, selection tint). Amber is the rare second voice: it marks the writing point in the icon and warnings in the interface (warning is #B45309 / #FBBF24). The gradient #7C74FF → #4F46E5 → #3730A3 is reserved for the three places that say "this is the main thing": the selected mode, a sheet's header badge, a prominent button.
Typography
- Interface: the system font at the sizes of the type ramp; a serif design only for the
displaytoken. - Documents: the default "ORIX" theme sets body text in New York and headings in SF Pro Display with the indigo accent (
Theme.orixinDocModel/Styles.swift). Other themes are neutral on purpose and carry no ORIX colour.
Tone of voice
Taken from the strings in the application:
- Say what happens, plainly. "Tables with vertically merged cells cannot be sorted." "The image could not be read." "Comments are not included in the PDF."
- Name limits before the user meets them. Export shows what a format cannot carry; the PDF option reads "Conformance to PDF/UA is not claimed."
- No exclamation marks, no superlatives, no humour in errors. Empty states explain the next step: "No headings yet. Apply a heading style and the contents will appear here."
- Menu vocabulary follows macOS: "Paste and Match Style", "Revert To", "Browse All Versions…", ellipsis on commands that open a sheet.
- Private by default, and said so: the reviewer name is "entered by the user; never sent anywhere" (
AppSettings.swift).
Do
- Use the plate and the ring unmodified when a new ORIX mark is drawn; vary the subject, not the ground.
- Keep indigo for state and selection; let one element per view carry the gradient.
- Leave the page white and the chrome quiet: the document is the content.
- Pair every colour signal with a shape, an icon or a word.
- Write interface text in sentence case for messages and title case for commands, as the existing strings do.
Don't
- Don't recolour the ring or place it on a light plate.
- Don't use amber for large surfaces or as a second selection colour.
- Don't imitate the icons of Microsoft Word or Apple Pages, or borrow a letter mark or pen motif from them: the ORIX Docs mark is the ring with a page.
- Don't add a claim the product cannot back ("accessible PDF", "PDF/A", "fully compatible with Word").
- Don't theme the paper in dark mode.