Repository Public
1<!--2ORIX Docs3File: docs/release/distribution.md4Description: The distribution artifacts of version 1.0.0: what they contain, how they are built, their sizes and checksums, how to install and verify them, and where they are published.5Author: Simon-Pierre Boucher6Contact: contact@spboucher.ai7-->8# Distribution910ORIX Docs is distributed outside the Mac App Store as a Developer ID–signed, notarized application ([signing.md](signing.md), [notarization.md](notarization.md)).1112## Artifacts of version 1.0.0 (build 2)1314From `dist/release.json` and `dist/SHA256SUMS.txt`. The `dist/` folder is ignored by git (`.gitignore`), so the facts are reproduced here.1516| File | Bytes | SHA-256 |17|---|---:|---|18| `ORIX-Docs-1.0.0.dmg` | 30810813 | `94144d313c91a029c44f2dc34add72f84a67dc35881875bcd36615aed5e7e38e` |19| `ORIX-Docs-1.0.0.zip` | 29762912 | `1957d5e30931068ae1926ba69d58639e2a975b5aae4183e7f3ca004a9df9d75e` |2021| Property | Value |22|---|---|23| Name | ORIX Docs |24| Version / build | 1.0.0 / 1 |25| Bundle identifier | `ai.spboucher.orix.docs` |26| Minimum system version | 15.0 |27| Architectures | x86_64, arm64 (universal) |28| Signing | Developer ID Application: Simon-Pierre Boucher (3YM54G49SN) |29| Notarization | application and disk image: Accepted |30| Gatekeeper | `accepted`, `source=Notarized Developer ID` for both |3132`shasum -a 256 -c SHA256SUMS.txt` was run in `dist/` on 2026-11-21 while writing this document and answered `OK` for both files.3334## What is in the application bundle3536* `Contents/MacOS/ORIX Docs` — the application, universal.37* `Contents/Helpers/orixdocs` — the command-line tool, universal, signed with the hardened runtime under the identifier `ai.spboucher.orix.docs.cli` ([automation.md](../development/automation.md#command-line-tool)).38* `Contents/Helpers/SwiftMath_SwiftMath.bundle` — the math fonts the tool needs.39* `Contents/Resources` — the icon and compiled asset catalogue (`AppIcon.icns`, `Assets.car`), the Canadian French strings (`fr-CA.lproj`; English is the source language), the App Intents metadata, and the SwiftMath resource bundle.4041The bundle contains no updater. Sparkle was evaluated ([technology-evaluation.md, section 10b](../research/technology-evaluation.md#10b-updates)) and is **not implemented in 1.0.0**: a new version is installed by downloading it. The evaluation notes that without an in-app updater, delivering a parser fix depends on users reinstalling; this is a known weakness of 1.0.0.4243## The disk image4445Built by [`Scripts/package.sh`](../../Scripts/package.sh) `<output.dmg>`:46471. The background artwork is drawn by [`design/dmg/make-background.swift`](../../design/dmg/make-background.swift): a 660 × 420 pt image at 1x and 2x with the ORIX ink gradient (`#1B1F3B` to `#0B0D1A`), a soft indigo glow, an arrow from the application to the Applications folder, the wordmark "ORIX DOCS", the tagline "Write Without Limits." and the instruction "Drag ORIX Docs to the Applications folder to install". The two sizes are combined into one TIFF with `tiffutil -cathidpicheck`.482. `create-dmg` lays out the window: volume name "ORIX Docs 1.0.0", window 660 × 448, icon size 112, the application at (180, 200), the Applications drop link at (480, 200).493. **Fallback.** If `create-dmg` is missing or fails (it scripts the Finder), the script builds a plain compressed image with `hdiutil` that contains the application and an Applications shortcut, **without the background artwork**, and says so on standard error.5051Which path produced an image is recorded only in `build/dmg/create-dmg.log`, a build product that is not committed. On 2026-11-21, when this document was written, that log ended with "Disk image done", the message of the `create-dmg` path (with artwork). The appearance of the mounted window was not captured in a screenshot.5253The disk image is then signed, notarized and stapled by `Scripts/notarize.sh`.5455## The ZIP archive5657`ditto -c -k --keepParent "dist/ORIX Docs.app"`, made after the application was stapled. It is the same application as in the disk image, for people and tools that prefer an archive.5859## Installing6061**Disk image:** open `ORIX-Docs-1.0.0.dmg` and drag *ORIX Docs* to *Applications*.6263**ZIP:** expand `ORIX-Docs-1.0.0.zip` and move *ORIX Docs.app* to *Applications*.6465**Verify:**6667```sh68shasum -a 256 ORIX-Docs-1.0.0.dmg ORIX-Docs-1.0.0.zip # compare with the table above69spctl --assess --type execute --verbose=2 "/Applications/ORIX Docs.app"70codesign --verify --deep --strict --verbose=2 "/Applications/ORIX Docs.app"71```7273**Command-line tool (optional):**7475```sh76"/Applications/ORIX Docs.app/Contents/Helpers/orixdocs" --version77```7879The application does not install a link to the tool anywhere; add one yourself if you want `orixdocs` on your `PATH`.8081**Uninstalling:** move the application to the Trash. The application writes outside its documents only to `~/Library/Application Support/ORIX Docs/Automation/` (workflow files and run history, [automation.md](../development/automation.md#workflows)), the default export folder `~/Documents/ORIX Docs Exports` when workflows are run from the app, and its preferences.8283## Where it is published8485| Channel | State |86|---|---|87| Private bare repository on the owner's git server (`gitsrv:srv/git-private/orix-docs.git`, SSH only) | Source hosted there, as stated by the maintainer. The working copy used to write this document has no git remote configured, so this was not verified from the repository itself. |88| Public repository on SPB Git (git.spboucher.ai) | **Published 2026-11-21** on the owner's instruction: https://git.spboucher.ai/orix-docs |89| SPB Git release `v1.0.0` with the DMG, the ZIP and `SHA256SUMS.txt` | **Created 2026-11-21.** https://git.spboucher.ai/orix-docs/releases — downloads verified against the checksums. |9091When the release is authorised: attach `ORIX-Docs-1.0.0.dmg`, `ORIX-Docs-1.0.0.zip` and `SHA256SUMS.txt`, copy the checksums above into the release notes, then check on the forge that the README renders (badges, Mermaid diagrams, images, HTML tables) and that the downloaded files match the checksums. Those checks are the last two lines of the [release checklist](checklist.md).9293## What was not verified9495* **No clean second Mac was used.** Download, quarantine, first launch and Gatekeeper's prompt were not exercised on a machine other than the build machine.96* **Intel.** The x86_64 slice is built and signed; it was never run. Development and all tests were on Apple silicon (Apple M5 Max, macOS 27.0).97* **macOS 15 to 26.** The deployment target is 15.0; the tests ran on macOS 27.0 only.98* **README rendering on SPB Git** and **release download links**: not checkable until publication.99