SPB Git

Repository Public

distribution.md 6.6 KB

# Distribution

ORIX Docs is distributed outside the Mac App Store as a Developer ID–signed, notarized application (signing.md, notarization.md).

# Artifacts of version 1.0.0 (build 2)

From dist/release.json and dist/SHA256SUMS.txt. The dist/ folder is ignored by git (.gitignore), so the facts are reproduced here.

File Bytes SHA-256
ORIX-Docs-1.0.0.dmg 30810813 94144d313c91a029c44f2dc34add72f84a67dc35881875bcd36615aed5e7e38e
ORIX-Docs-1.0.0.zip 29762912 1957d5e30931068ae1926ba69d58639e2a975b5aae4183e7f3ca004a9df9d75e
Property Value
Name ORIX Docs
Version / build 1.0.0 / 1
Bundle identifier ai.spboucher.orix.docs
Minimum system version 15.0
Architectures x86_64, arm64 (universal)
Signing Developer ID Application: Simon-Pierre Boucher (3YM54G49SN)
Notarization application and disk image: Accepted
Gatekeeper accepted, source=Notarized Developer ID for both

shasum -a 256 -c SHA256SUMS.txt was run in dist/ on 2026-11-21 while writing this document and answered OK for both files.

# What is in the application bundle

  • Contents/MacOS/ORIX Docs — the application, universal.
  • Contents/Helpers/orixdocs — the command-line tool, universal, signed with the hardened runtime under the identifier ai.spboucher.orix.docs.cli (automation.md).
  • Contents/Helpers/SwiftMath_SwiftMath.bundle — the math fonts the tool needs.
  • 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.

The bundle contains no updater. Sparkle was evaluated (technology-evaluation.md, section 10b) 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.

# The disk image

Built by Scripts/package.sh <output.dmg>:

  1. The background artwork is drawn by 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.
  2. 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).
  3. 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.

Which 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.

The disk image is then signed, notarized and stapled by Scripts/notarize.sh.

# The ZIP archive

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.

# Installing

Disk image: open ORIX-Docs-1.0.0.dmg and drag ORIX Docs to Applications.

ZIP: expand ORIX-Docs-1.0.0.zip and move ORIX Docs.app to Applications.

Verify:

sh
shasum -a 256 ORIX-Docs-1.0.0.dmg ORIX-Docs-1.0.0.zip      # compare with the table above
spctl --assess --type execute --verbose=2 "/Applications/ORIX Docs.app"
codesign --verify --deep --strict --verbose=2 "/Applications/ORIX Docs.app"

Command-line tool (optional):

sh
"/Applications/ORIX Docs.app/Contents/Helpers/orixdocs" --version

The application does not install a link to the tool anywhere; add one yourself if you want orixdocs on your PATH.

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), the default export folder ~/Documents/ORIX Docs Exports when workflows are run from the app, and its preferences.

# Where it is published

Channel State
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.
Public repository on SPB Git (git.spboucher.ai) Published 2026-11-21 on the owner's instruction: https://git.spboucher.ai/orix-docs
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.

When 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.

# What was not verified

  • 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.
  • 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).
  • macOS 15 to 26. The deployment target is 15.0; the tests ran on macOS 27.0 only.
  • README rendering on SPB Git and release download links: not checkable until publication.
Files main
Menu

Theme