Skip to content

Commit 16d20b3

Browse files
committed
release: v0.1.1 β€” app icon, corrected install docs
- Add an eye app icon (src-tauri/app-icon.svg β†’ generated icons), replacing the default Tauri logo so mad-eye looks right in the Apps list, Finder, and DMG. - Fix the install docs: an unsigned build is NOT cleared by Homebrew, which quarantines casks by default β€” so the old "Homebrew handles it" and the dead "right-click β†’ Open" (removed on recent macOS) were both wrong. Document `--no-quarantine` / System Settings β†’ Privacy & Security β†’ Open Anyway instead. - Tidy Cargo.toml metadata (description, authors).
1 parent ec85f07 commit 16d20b3

24 files changed

Lines changed: 46 additions & 13 deletions

β€Ž.claude/skills/release/SKILL.mdβ€Ž

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ argument-hint: "[patch|minor|major]"
77

88
Cut ONE release of **mad-eye** (the macOS menubar app) to **GitHub Releases + a Homebrew cask**. Every step ends on a gate β€” a checkable condition; stop and report at the first gate that fails.
99

10-
Distribution is **unsigned/ad-hoc on purpose**: mad-eye uses `macOSPrivateApi` (the transparent + vibrancy Popover), which bars the Mac App Store, and its audience is Claude Code users (small, technical). So we ship a **Homebrew cask** β€” which strips the Gatekeeper quarantine flag on install, so an unsigned build installs clean β€” instead of paying for an Apple Developer ID + notarization. Graduate to signing only if it gets real traction. The app version lives in `src-tauri/tauri.conf.json` (`CFBundleVersion` derives from it); `package.json` + `src-tauri/Cargo.toml` mirror it in lockstep.
10+
Distribution is **unsigned/ad-hoc on purpose**: mad-eye uses `macOSPrivateApi` (the transparent + vibrancy Popover), which bars the Mac App Store, and its audience is Claude Code users (small, technical). So we ship an unsigned **Homebrew cask**: users install with `--no-quarantine` (or approve once via System Settings β†’ Privacy & Security) because macOS Gatekeeper flags unsigned apps β€” cheaper than an Apple Developer ID + notarization, at the cost of that one-time friction. Graduate to signing only if it gets real traction. The app version lives in `src-tauri/tauri.conf.json` (`CFBundleVersion` derives from it); `package.json` + `src-tauri/Cargo.toml` mirror it in lockstep.
1111

1212
**One-time setup** (before the FIRST release, else Step 1/3/5 gates fail): a GitHub remote exists (`git remote add origin …` + an initial push); both universal Rust targets installed (`rustup target add aarch64-apple-darwin x86_64-apple-darwin`); `gh` authenticated. The Homebrew tap (`kvnwolf/homebrew-tap`) and its cask are scaffolded by Step 5 on the first release if missing.
1313

@@ -110,7 +110,7 @@ end
110110

111111
## Step 6: Smoke + report
112112

113-
- Optional local smoke (skip if the user doesn't want it live-installed on this machine): `brew install --cask kvnwolf/tap/mad-eye` (add `--force` to reinstall over an existing copy) installs with NO Gatekeeper prompt β€” the cask strips the quarantine flag.
113+
- Optional local smoke (skip if the user doesn't want it live-installed on this machine): `brew install --cask --no-quarantine kvnwolf/tap/mad-eye` (add `--force` to reinstall over an existing copy) β€” `--no-quarantine` skips Gatekeeper so the unsigned app opens directly; without it macOS blocks the first launch.
114114
- Report to the user: version published, inferred bump + reasoning, DMG path + `sha256`, tag + GitHub release URL, cask commit URL, and the `brew install --cask kvnwolf/tap/mad-eye` command.
115115

116116
## Acceptance checklist

β€ŽREADME.mdβ€Ž

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -56,19 +56,28 @@ popover to make it the one that drives the Eye (it remembers your choice).
5656

5757
## Install
5858

59+
> mad-eye isn't code-signed yet (free, unsigned build), so macOS Gatekeeper flags it on first
60+
> launch. Both paths below get you past that.
61+
5962
### Homebrew (recommended)
6063

6164
```sh
62-
brew install --cask kvnwolf/tap/mad-eye
65+
brew install --cask --no-quarantine kvnwolf/tap/mad-eye
6366
```
6467

68+
`--no-quarantine` skips Gatekeeper's quarantine so the app opens straight away β€” reasonable for an
69+
open-source tool whose [source you can read](src-tauri/src). Prefer to keep the check? Install
70+
without the flag, then approve it once under **System Settings β†’ Privacy & Security β†’ Open Anyway**.
71+
6572
### Manual
6673

67-
Download the latest `.dmg` from [**Releases**](https://github.com/kvnwolf/mad-eye/releases),
68-
open it, and drag **mad-eye** into Applications.
74+
Download `mad-eye_<version>_universal.dmg` from [**Releases**](https://github.com/kvnwolf/mad-eye/releases),
75+
open it, and drag **mad-eye** into Applications. Then approve it under **System Settings β†’ Privacy &
76+
Security β†’ Open Anyway**, or clear the quarantine flag yourself:
6977

70-
> It's an unsigned build, so the first time: **right-click β†’ Open** (or run
71-
> `xattr -dr com.apple.quarantine /Applications/mad-eye.app`). Homebrew does this for you.
78+
```sh
79+
xattr -dr com.apple.quarantine /Applications/mad-eye.app
80+
```
7281

7382
## Requirements
7483

β€Žpackage.jsonβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "mad-eye",
33
"private": true,
4-
"version": "0.1.0",
4+
"version": "0.1.1",
55
"type": "module",
66
"scripts": {
77
"dev": "vite",

β€Žsrc-tauri/Cargo.lockβ€Ž

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

β€Žsrc-tauri/Cargo.tomlβ€Ž

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
[package]
22
name = "mad-eye"
3-
version = "0.1.0"
4-
description = "A Tauri App"
5-
authors = ["you"]
3+
version = "0.1.1"
4+
description = "Menubar Eye tracking Claude subscription usage"
5+
authors = ["Kevin Wolf"]
66
edition = "2021"
77

88
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

β€Žsrc-tauri/app-icon.svgβ€Ž

Lines changed: 24 additions & 0 deletions
Loading

β€Žsrc-tauri/icons/128x128.pngβ€Ž

1.91 KB
Loading
3.91 KB
Loading

β€Žsrc-tauri/icons/32x32.pngβ€Ž

290 Bytes
Loading

β€Žsrc-tauri/icons/64x64.pngβ€Ž

2.54 KB
Loading

0 commit comments

Comments
Β (0)