prole/BUILD.md

Quick Build Guide

Build the Installer

# One command to build everything
make package

This creates dist/Knoe Installer.app - a self-contained macOS application.

Usage

GUI Mode (double-click):

• Open dist/Knoe Installer.app in Finder

Command-line:

# Auto-detect display (GUI or ncurses)
./dist/Knoe\ Installer.app/Contents/MacOS/knoe-installer

# Force ncurses mode
./dist/Knoe\ Installer.app/Contents/MacOS/knoe-installer --no-gui

Install to /Applications

cp -r "dist/Knoe Installer.app" /Applications/

Makefile Targets

• make help - Show available targets
• make install - Install build dependencies
• make build - Build the binary
• make package - Create .app bundle
• make clean - Remove build artifacts
• make test - Test the built binary

First-time Setup

make install  # Install PyInstaller and dependencies
make package  # Build everything

Details

See docs/build-system.md for complete documentation.