Skip to content

v2.0.0: Desktop app (superseded)

Choose a tag to compare

View all tags
@daddu-boy daddu-boy released this 23 Jul 11:18
· 85 commits to main since this release
v2.0.0
8f091f6

Superseded. Please do not install this.

May or Shall is now a hosted web app at app.mayorshall.com. Sign in with your email address; there is nothing to download. The installers below run a local server on your own machine and will not connect to it. They are left here for the record only, and are not maintained or supported.

For the current Web Clipper and Word add in, see the latest release.

Original release notes from July 2026

May or Shall is now a desktop app. No terminal, no Docker, no database, no setup.

Get started

  1. Download the installer for your computer:
    • macOS — Apple Silicon (M1/M2/M3…) or Intel .dmg
    • Windows — May-or-Shall-Windows-Setup.exe
  2. Install and open it. First launch shows an "unidentified developer / unknown publisher" notice because the app isn't code-signed yet:
    • macOS: right-click the app → Open → Open (once).
    • Windows: More info → Run anyway on the SmartScreen prompt (once).
  3. Install the Chrome extension. It finds the running app automatically — nothing to configure. Clip from any page, and it lands in your matter.

Everything stays on your own computer — your case data never leaves the machine.

Windows note: the Windows build is cross-compiled and not yet tested on Windows hardware end-to-end. It's structurally identical to the macOS build (which is fully verified). Please report anything that misbehaves via Issues.

What changed

  • Desktop app (macOS + Windows): runs the whole workspace in-process with its own single-file database and PDF storage under your app-data folder.
  • Web Clipper v1.2.0: auto-detects the app over http or https, so a fresh install connects with zero configuration.
  • SQLite everywhere: the app no longer needs PostgreSQL. Running from source is now just npm install && npx prisma migrate deploy && npm run dev. Existing Postgres users can migrate with scripts/migrate-pg-to-sqlite.mjs.

Word add-in

Unchanged from v1.1.x — sideload may-or-shall-word-manifest-hosted.xml (hosted pane) or may-or-shall-word-manifest.xml (local). See the README.

A code-signed build (no first-launch warning) and Linux builds are planned.

Assets 8
Loading