SPB Git

Repository Public License

brand-guidelines.md 4.8 KB 88 lines markdown

1<!--2ORIX Scan3File: docs/design/brand-guidelines.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->78# ORIX brand guidelines910ORIX is a family of independent, premium Apple utilities. ORIX Scan is the first one built to these guidelines.1112## Principles1314| Principle | What it means in practice |15|---|---|16| **Instant Utility** | The first screen offers the main action. No onboarding, no permission request at launch: the camera is asked for when the user scans. |17| **No Accounts** | There is nothing to register for or sign in to, anywhere in the app. |18| **Privacy by Design** | Processing happens on the device. The app has no networking code, no analytics and no advertising SDK. |19| **Professional Power** | Advanced tools (page organization, text correction, table export, workflows) are one level down, never in the way of the simple path. |20| **Exceptional Craftsmanship** | One design system, one elevation, consistent spacing and motion, real states for loading, empty and error. |21| **Reliability First** | A feature that cannot be made reliable is left out or labelled as an estimate. Nothing is silently lost: creation is staged, writes are atomic, deletion goes through Recently Deleted. |2223## Identity of ORIX Scan2425**Mark.** The ORIX "O" drawn as four viewfinder arcs, crossed by a horizontal beam. The ring is the brand letter and the26capture frame at once. The exploration, the scoring of the five concepts and the construction are in27[icon-design.md](icon-design.md).2829![ORIX Scan icon](../assets/icon-256.png)3031![Icon appearances](../assets/icon-appearances.png)3233**Family rule.** Every ORIX app shares the construction (the "O" ring on a continuous-corner tile) and differs by its34accent pair and inner glyph.3536**Accent pair.** Indigo (`#5B5BF0`, `#8484FF` in dark) with cyan (`#0FB5CF`, `#22D3EE` in dark), the "optical beam".37Indigo carries actions and selection; cyan is reserved for processing, progress and the beam.3839**Surfaces.** Calm neutrals with a slight blue cast. Documents sit on a `desk` colour that is never pure white, so the40paper always reads as an object.4142**Assets.**4344| Asset | File |45|---|---|46| Lockup (icon and wordmark) | [`docs/assets/logo.svg`](../assets/logo.svg) |47| Icon, 1024 px | [`docs/assets/icon-1024.png`](../assets/icon-1024.png) |48| Icon, 256 px with rounded mask | [`docs/assets/icon-256.png`](../assets/icon-256.png) |49| Concept sheet | [`docs/assets/concepts.png`](../assets/concepts.png) |50| Master artwork and generator | `design/icon/master/`, `design/icon/build.py` |5152Tokens and components: [design-system.md](design-system.md).5354## Voice5556The interface speaks plainly and tells the truth about what the app does.5758- **Plain.** Short sentences, common words. "Recognize Text", not "Run OCR pipeline".59- **Factual.** Numbers are measured values: file sizes come from the file that was built, confidence from the recognizer.60  Where the app estimates, it says so ("These are estimates. If the page looks right to you, you can ignore them.").61- **No hype.** No "magic", "AI-powered", "instantly", "perfect". Limits are stated where they matter ("Tables are62  reconstructed from text positions. Highlighted cells are uncertain").63- **Says where things happen.** Processing messages name the device: "Recognizing text on this device…", "Everything runs64  on this device."65- **Errors help.** A title that names the problem, a message that says what to do and whether anything was lost66  ("Free up space on this device, then try again. Nothing was lost.").67- **Advice, not orders.** Quality warnings can be dismissed or turned off.68- **Capitalization.** Title Case for buttons, menu items and titles; sentence case for messages. Canadian spelling in69  English ("Colour", "Favourites"). French (Canada) follows the wording Apple uses in iOS.7071## Do and don't7273| Do | Don't |74|---|---|75| Put the main action first and make it the largest target | Add a welcome flow or ask for permissions at launch |76| Use the accent for actions and the beam colour for processing | Use the accent as decoration or tint whole screens |77| Show real states: progress with Cancel, empty states with a next step | Show a spinner with no way out, or an empty screen |78| Label estimates as estimates and show measured values | Display invented or rounded-up numbers |79| Keep one elevation and the system materials | Stack glass effects, glows or heavy shadows |80| Pair colour with a symbol and text | Rely on colour alone to carry meaning |81| Use the mark at a size where the four arcs are distinct | Redraw the mark, change its proportions or recolour the beam |8283## The family today8485ORIX Audio and ORIX Calc exist as sibling projects in the same workspace. They were built separately and each has its own86design code. Bringing the three apps onto one shared `ORIXDesign` package, with one accent pair per app, is future work;87nothing in this repository depends on the other two.88
Files main
Menu

Theme