Skip to content

Installation

Plain is currently distributed as Plain 1.0 Beta for macOS. The beta is ad-hoc signed and not notarized.

Download the latest build from GitHub Releases.

Use the .dmg for the easiest install, or the .zip if you prefer the raw .app bundle.

Each release includes SHA256SUMS.txt so you can verify downloaded artifacts:

Terminal window
shasum -a 256 -c SHA256SUMS.txt

Plain is ad-hoc signed and not notarized. macOS may warn when opening a downloaded build.

If macOS blocks the app, choose Open Anyway in the warning dialog. You can also open System Settings > Privacy & Security, find the Plain warning near the bottom, and allow it there.

macOS warning dialog for opening unsigned Plain.app with an Open Anyway button

The app does not require an Apple Developer Program membership to build locally or distribute unsigned builds.

From the repository root:

Terminal window
make run

or directly:

Terminal window
swift run Plain

Run the Swift tests:

Terminal window
make test

Run Swift tests plus claim-policy tests:

Terminal window
make test-all

Build the app, ZIP, and DMG:

Terminal window
make package

For a faster local packaging smoke build:

Terminal window
make package-fast

For packaging with claim tests enabled:

Terminal window
make package-claims

Packaged builds include App Sandbox and network-client entitlements.