christian/commitea
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
354ba9227e6b43aa3358bd2a85481b3f95b6cdd7
commitea/apps/desktop/README.md
Croissant Le Doux 19897f7e53 Phase C: package as an unsigned macOS .dmg (electron-builder) 
Adds shareable desktop packaging so the app can be handed to teammates.

- electron-builder@25 + electron-builder.yml: appId io.stephenmann.commitea,
  productName CommiTea, icon from the logo (build/icon.png, 1024²), macOS dmg
  targets for arm64 + x64. Ships only out/** (electron-vite already bundles
  renderer/preload/main with core + react inlined), npmRebuild off,
  electronVersion pinned to 34.5.8 (workspace hoisting defeats auto-detect).
- Unsigned by decision: mac.identity null, hardenedRuntime off. electron-builder
  ad-hoc signs so arm64 runs; not notarized — teammates right-click → Open once.
- Scripts: `yarn pack` (--dir sanity build), `yarn dist` (both dmgs). package.json
  gains version/author/description (required by electron-builder).
- README.md: dev/build/package commands + the Gatekeeper install step.

Verified: packaged arm64 app boots from a fresh profile (lands on onboarding);
`yarn dist` produced CommiTea-0.1.0-arm64.dmg (98M) and CommiTea-0.1.0.dmg (x64,
102M), each mounting with a drag-to-Applications layout.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-09 02:46:37 -04:00

1.7 KiB
Raw Blame History

CommiTea (desktop)

An AI project manager for Gitea, as an Electron desktop app. The token stays in the main process (OS keychain via safeStorage); the renderer never sees it.

Develop

yarn dev          # electron-vite dev, HMR renderer + main (logs → desktop.log)
yarn typecheck
yarn e2e          # builds, then Playwright against the built main (fixtures/demo)

For a live pass against a real Gitea, put a token in .env.local (GITEA_TOKEN=…) and run GITEA_LIVE=1 yarn e2e live-onboarding.

Package (shareable macOS .dmg)

yarn pack         # unpacked .app for the host arch (fast sanity check) → dist/
yarn dist         # arm64 + x64 .dmg → dist/CommiTea-<version>[-arm64].dmg

Config is electron-builder.yml. Builds are unsigned (no Apple certs, by decision) — electron-builder ad-hoc signs so the app can run, but it is not notarized. Bump version in package.json for a new release; keep electronVersion in electron-builder.yml in sync with the electron devDependency.

Installing a shared build (teammates)

macOS Gatekeeper blocks unsigned apps on first launch. To open:

  1. Open the .dmg and drag CommiTea to Applications.
  2. In Applications, right-click CommiTea → Open, then confirm Open in the dialog. (Double-clicking the first time just shows "cannot be opened".)
  3. It opens to the connection screen — enter your Gitea base URL, owner/repo, and a personal access token (repo scope). Each teammate uses their own token, so activity is attributed correctly. A model URL is optional; chat is disabled until one is configured, everything else works without it.

Grab the -arm64 dmg on Apple Silicon, the plain one on Intel.