Add macOS install instructions and DMG build tooling

- Add Installation section to README with xattr fix for Gatekeeper warning
- Add dmg-assets/Install Instructions.txt shown inside the DMG window
- Add scripts/build-dmg.sh using create-dmg for custom DMG packaging
- Add build:dmg npm script
- Bump version to 0.1.1

Author: pstepanovum

README.md

@@ -15,6 +15,20 @@ Browse, filter by BPM/key, preview audio and MIDI, and organize your own library
 
 **Download:** [stack.swendl.com](https://stack.swendl.com)
 
+## Installation (macOS)
+
+1. Download the `.dmg` from the releases page or [stack.swendl.com](https://stack.swendl.com)
+2. Open the DMG and drag **Stack.app** to your Applications folder
+3. If macOS says _"Stack is damaged and can't be opened"_, run this once in Terminal:
+
+```bash
+xattr -rd com.apple.quarantine /Applications/Stack.app
+```
+
+4. Launch Stack from Applications
+
+> This warning appears because the app is not yet notarized with Apple. The command removes the quarantine flag macOS applies to downloaded files.
+
 ## Features
 
 - Offline-first desktop app

dmg-assets/Install Instructions.txt

@@ -0,0 +1,16 @@
+Stack — Install Instructions
+─────────────────────────────
+
+1. Drag Stack.app to the Applications folder on the right.
+
+2. Launch Stack from Applications or Spotlight.
+
+3. If macOS says "Stack is damaged and can't be opened",
+   open Terminal and run:
+
+   xattr -rd com.apple.quarantine /Applications/Stack.app
+
+   Then launch normally.
+
+─────────────────────────────
+stack.swendl.com

package.json

@@ -9,7 +9,8 @@
     "preview": "vite preview",
     "tauri": "tauri",
     "db:clear": "rm -f \"$HOME/Library/Application Support/app.stack.desktop/stack.db\" \"$HOME/Library/Application Support/app.stack.desktop/stack.db-wal\" \"$HOME/Library/Application Support/app.stack.desktop/stack.db-shm\"",
-    "tauri:dev:cleardb": "npm run db:clear && npm run tauri dev"
+    "tauri:dev:cleardb": "npm run db:clear && npm run tauri dev",
+    "build:dmg": "bash scripts/build-dmg.sh"
   },
   "dependencies": {
     "@crabnebula/tauri-plugin-drag": "^2.1.0",

scripts/build-dmg.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+set -e
+
+cd "$(dirname "$0")/.."
+
+APP_NAME="Stack"
+ARCH="aarch64"
+VERSION=$(node -p "require('./src-tauri/tauri.conf.json').version" 2>/dev/null || grep '"version"' src-tauri/tauri.conf.json | head -1 | sed 's/.*"version": "\(.*\)".*/\1/')
+DMG_NAME="${APP_NAME}_${VERSION}_${ARCH}.dmg"
+APP_PATH="src-tauri/target/release/bundle/macos/${APP_NAME}.app"
+OUTPUT_DIR="src-tauri/target/release/bundle/dmg"
+STAGING_DIR="/tmp/dmg-staging-${APP_NAME}"
+
+if ! command -v create-dmg &> /dev/null; then
+  echo "Error: create-dmg not found. Install it with: brew install create-dmg"
+  exit 1
+fi
+
+echo "Building ${APP_NAME} v${VERSION}..."
+npm run tauri build -- --bundles app
+
+mkdir -p "$OUTPUT_DIR"
+rm -f "$OUTPUT_DIR/$DMG_NAME"
+rm -rf "$STAGING_DIR"
+mkdir -p "$STAGING_DIR"
+
+cp -r "$APP_PATH" "$STAGING_DIR/"
+cp "dmg-assets/Install Instructions.txt" "$STAGING_DIR/"
+
+create-dmg \
+  --volname "$APP_NAME" \
+  --background "src-tauri/icons/dmg-bg-gray-dots.png" \
+  --window-pos 200 120 \
+  --window-size 660 400 \
+  --icon-size 100 \
+  --icon "${APP_NAME}.app" 180 170 \
+  --hide-extension "${APP_NAME}.app" \
+  --app-drop-link 480 170 \
+  --icon "Install Instructions.txt" 330 310 \
+  "$OUTPUT_DIR/$DMG_NAME" \
+  "$STAGING_DIR"
+
+rm -rf "$STAGING_DIR"
+
+echo "Done: $OUTPUT_DIR/$DMG_NAME"

src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "stack"
-version = "0.1.0"
+version = "0.1.1"
 description = "Local sample library manager"
 authors = ["Stack"]
 edition = "2021"

src-tauri/tauri.conf.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "Stack",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "identifier": "app.stack.desktop",
   "build": {
     "beforeDevCommand": "npm run dev",