SPB Git

Repository Public

brand-guidelines.md 4.6 KB

# 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 ORIX Docs icon: an indigo ring on a dark plate, a white page with text lines and an amber caret

# 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 display token.
  • Documents: the default "ORIX" theme sets body text in New York and headings in SF Pro Display with the indigo accent (Theme.orix in DocModel/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.
Files main
Menu

Theme