SPB Git

Repository Public License

brand-guidelines.md 7.4 KB 130 lines markdown

1<!-- ORIX Clean / File: docs/design/brand-guidelines.md / Author: Simon-Pierre Boucher / Contact: contact@spboucher.ai -->2# Brand guidelines34How ORIX Clean presents itself: name, tagline, voice and visual identity. The rules below describe what the5shipped strings and assets already do, so that new text and artwork stay consistent with them.67## Name and tagline89| Element | Form | Where it appears |10|---|---|---|11| Product name | **ORIX Clean** | Window title, bundle display name, disk image, report footers |12| Tagline | **ORIX Clean — Reclaim Space. Keep Control.** | Onboarding ("Reclaim space. Keep control."), disk-image background |13| Bundle identifier | `ai.spboucher.orix.clean` | `project.yml` |14| Category | Utilities (`public.app-category.utilities`) | `Info.plist` |15| Copyright | © 2026 Simon-Pierre Boucher | `Info.plist` |1617Writing the name:1819- "ORIX" is always in capitals; "Clean" has a capital C; there is a space between them. Not "Orix Clean",20  "ORIXClean" or "ORIX CLEAN" in prose. (`ORIXClean` without a space is used only in file names, the Xcode21  target and artifact names such as `ORIXClean-1.0.0.dmg`.)22- The name is not translated. In French text it stays "ORIX Clean".23- The tagline has two halves that belong together. "Reclaim Space" is the benefit; "Keep Control" is the24  condition under which the product delivers it. Do not use the first half alone.25- Feature names are plain descriptive words: Storage Map, Large Files, Duplicates, Similar Images,26  Caches & Logs, Developer, Downloads, Applications, Trash, History, Actions, Reports.2728## ORIX family principles2930ORIX Clean is one of the ORIX applications. The family shares a few commitments, which here take a concrete31form that can be checked in the code.3233| Principle | In ORIX Clean |34|---|---|35| **Native** | SwiftUI and AppKit, system controls, SF Symbols, system fonts. No web views (the repository check rejects `WKWebView`) |36| **Local** | No account, no network code, no analytics. Image analysis runs on the Mac with Vision |37| **Honest** | Every figure is measured; what could not be read is stated; estimates are labelled as estimates and given as ranges |38| **The user decides** | Nothing preselected, nothing removed without a preview and a confirmation, removal goes to the Trash |39| **Quiet** | No notifications, no badges demanding attention, no background activity when the window is closed |40| **Shared visual base** | The family canvas, surface and hairline colours and the family indigo; each product adds its own accent |4142## Tone of voice4344**Factual. No urgency. No fear.**4546The interface describes the state of the disk and the consequence of each action. It does not tell the user47how to feel about either.4849### Rules50511. **State what was measured.** Give the number, the unit and the scope. "%d project folders in DerivedData52   use %@." is the pattern, not "Your Mac is cluttered".532. **State the consequence of acting.** Every candidate has a consequence sentence: what will be slower, lost54   or downloaded again.553. **State what is not known.** "Inferred from the name only. Not proof that the item is orphaned."56   "Perceptual similarity is not equality."574. **No urgency.** No "now", "immediately", "before it is too late", countdowns or exclamation marks.585. **No fear.** No "junk", "danger", "at risk", "infected", "critical", health scores or red alarm banners.59   A risk level describes the item, not the user's situation.606. **No exaggeration.** No "boost", "optimize", "supercharge", "like new". The app reclaims space; it does not61   claim to make the Mac faster.627. **Say who does what.** "macOS did not allow reading…", "macOS reports…", "ORIX Clean cannot know whether63   you still need it." Refusals are attributed to their source.648. **Destructive actions are named exactly.** "Move 12 Items to Trash", "Delete Permanently". Never a vague65   "Clean" on the button that acts.669. **Short sentences, second person, present tense.** Sentence case for text, title case for menu items and67   buttons, as on macOS.6869### Examples from the shipped strings7071| Situation | Text |72|---|---|73| Low free space | "%@ is running low on free space" with evidence "%@ free of %@ (%d%%)." |74| Growth trend | "A projection from past samples, not a forecast: growth may stop or accelerate." |75| Cache candidate | "The application rebuilds it the next time it needs it; the first launches may be slower." |76| Xcode archives | "The archived builds can no longer be re-exported, and their crash reports can no longer be symbolicated from this Mac." |77| After a cleanup | "%@ is now in the Trash and still occupies disk space. It is reclaimed when you empty the Trash." |78| Permission refused | "macOS did not allow reading the Trash. Grant Full Disk Access to ORIX Clean to see its content, or empty it from Finder." |79| Full Disk Access | "Optional. Without it ORIX Clean still works on everything macOS lets it read, and tells you what was not read." |80| Manual selection | "The item goes to the Trash. ORIX Clean cannot know whether you still need it." |8182### Words8384| Prefer | Avoid |85|---|---|86| size on disk, content size, estimated recoverable | wasted space, junk size |87| candidates, items, selection | junk, clutter, garbage |88| review, confirm | fix, repair, optimize |89| move to Trash, delete permanently | clean up now, wipe, shred |90| low risk, review required, high risk | safe, dangerous |91| could not be read, not counted | error, failure (unless it is one) |9293### French (fr-CA)9495The French interface follows the same rules. Translations live in `Scripts/translations-fr.json` and are96written for Canadian French: a space before a colon, « » quotation marks where quotes are needed, the97typographic apostrophe, macOS vocabulary as used in the French system (Corbeille, Téléchargements), and the98same absence of urgency. The tagline reads « Récupérez de l’espace. Gardez le contrôle. »99100## Visual identity101102| Element | Rule |103|---|---|104| Icon | The storage ring with a swept quarter; see `icon-design.md`. Use the supplied PNGs; do not redraw, recolour, rotate or crop |105| Accent | Teal: `#0A9E96` on light, `#2DD4BF` on dark |106| Secondary | Family indigo: `#5B5BF0` on light, `#8484FF` on dark |107| Brand gradient | `#2DD4BF` to `#06B6D4` to `#5B5BF0`, top-leading to bottom-trailing |108| Dark plate | `#1B2340` to `#070A16`, as on the icon and the disk-image background |109| Risk colours | Green, amber and red are reserved for risk levels and outcomes. Do not use red for emphasis or marketing |110| Typeface | The system font. No brand typeface |111| Symbols | SF Symbols only, in the weights the system provides |112113The 1024-pixel artwork already includes its margin (the plate is inset 100 pixels on each side) and its drop114shadow; do not add another plate or shadow behind it. At small sizes use the matching asset from the asset115catalogue rather than scaling the large one at run time.116117## Screenshots and marketing material118119- Use the generated sample folder (`orix-bench fixture`) rather than a real home folder; never show real file120  names of a real person.121- Do not show a "space freed" figure that the application did not measure and display itself.122- Do not compare against named products with numbers that were not measured.123- Do not state that a build is signed, notarized or published unless the release checklist records it.124125## What the brand is not126127- Not a "Mac health" or security product.128- Not an optimizer; it makes no performance claim.129- Not an account-based service; the code contains no account system and no licence check.130
Files main
Menu

Theme