diff --git a/BUILD_MACOS.md b/BUILD_MACOS.md deleted file mode 100644 index dae122a8..00000000 --- a/BUILD_MACOS.md +++ /dev/null @@ -1,60 +0,0 @@ -# BitChat macOS Build - -This Justfile provides easy commands to build and run BitChat natively on macOS while preserving the original project configuration. - -## Quick Start - -```bash -# Build and run the app -just run - -# Or see all available commands -just -``` - -## Commands - -- `just run` - Build and run the macOS app -- `just build` - Build the macOS app only -- `just clean` - Clean build artifacts and restore original files -- `just check` - Check prerequisites (XcodeGen, Xcode, etc.) -- `just info` - Show app information and requirements - -## How It Works - -The Justfile temporarily modifies `project.yml` to: -- Use your local development team ID (replaces `L3N5LHJD5Y`) -- Change bundle identifier to avoid conflicts (`chat.bitchat` → `com.local.bitchat`) -- Disable code signing for local development (`Automatic` → `Manual`) -- Exclude iOS-specific files from macOS build (`LaunchScreen.storyboard`) - -**Original files are always preserved** - modifications are only applied during builds and automatically cleaned up. The project files remain exactly as they are on the main branch. - -## Requirements - -- macOS 13.0+ (Ventura) -- Xcode (from App Store) -- XcodeGen (`brew install xcodegen`) -- Bluetooth LE capable Mac -- Physical device (Bluetooth doesn't work in simulator) - -## App Features - -- **Native macOS SwiftUI app** - not a Catalyst port -- **Bluetooth LE mesh networking** - no internet required -- **End-to-end encryption** - X25519 + AES-256-GCM -- **Store-and-forward messaging** - works with offline peers -- **Channel-based group chats** - IRC-style commands -- **Private messaging** with delivery receipts -- **Emergency wipe** - triple-tap logo to clear all data - -## Usage - -Once running: -- Set your nickname and start discovering nearby peers -- Use `/join #channel` for group chats -- Use `/msg @user` for private messages -- Use `/who` to see connected peers -- Triple-tap the logo for emergency data wipe - -The app creates a decentralized mesh network over Bluetooth LE that can span significant distances through multi-hop message relay.