Skip to content

chore: Add Makefile and restructure install.sh for /Applications install - #43

Merged
jatinkrmalik merged 1 commit into
mainfrom
chore/install-script-and-makefile
Mar 6, 2026
Merged

chore: Add Makefile and restructure install.sh for /Applications install#43
jatinkrmalik merged 1 commit into
mainfrom
chore/install-script-and-makefile

Conversation

@jatinkrmalik

Copy link
Copy Markdown
Member

Problem

Building from source and running open VocaMac.app from the repo root causes permission issues — macOS assigns permissions to Terminal instead of VocaMac. Users had to figure out the workaround themselves.

Solution

New install.sh (two modes)

Command What it does
./scripts/install.sh Build .app, copy to /Applications, launch. Permissions go to VocaMac directly.
./scripts/install.sh --cli Install vocamac + vocamac-build CLI commands to ~/.local/bin (old behavior).

Makefile

Command What it does
make install Build + install to /Applications (recommended)
make install-cli Install CLI commands to ~/.local/bin
make build Build .app bundle in repo root (fast dev iteration)
make test Run tests
make run Launch the locally built .app
make clean Remove build artifacts
make help Show available commands

Quick start is now:

git clone https://github.com/jatinkrmalik/vocamac.git
cd vocamac
make install

Docs updated

  • README.md — Quick Start (3 options: DMG, make install, make install-cli), Build Commands, Project Structure
  • AGENTS.md — Build & Run section, Repository Structure
  • docs/ARCHITECTURE.md — Build Commands section

What stays the same

  • build.sh — unchanged, still the fast dev iteration tool
  • uninstall.sh — unchanged
  • CI workflows — unchanged (swift build + swift test + build.sh release)

- install.sh (default): builds .app bundle via build.sh, copies to
  /Applications, and launches. Permissions are granted directly to
  VocaMac — no terminal permission workarounds needed.
- install.sh --cli: keeps the old behavior — installs vocamac and
  vocamac-build CLI commands to ~/.local/bin
- Makefile: make install, make build, make install-cli, make test,
  make run, make clean, make help
- Updated README Quick Start: DMG as Option 1, make install as Option 2,
  make install-cli as Option 3
- Updated AGENTS.md and ARCHITECTURE.md build sections
@jatinkrmalik
jatinkrmalik merged commit 8fb1082 into main Mar 6, 2026
1 check passed
@jatinkrmalik
jatinkrmalik deleted the chore/install-script-and-makefile branch August 22, 2026 05:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant