mirror of
https://github.com/permissionlesstech/bitchat.git
synced 2026-07-25 12:05:19 +00:00
Delete BUILD_MACOS.md
This commit is contained in:
@@ -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.
|
||||
Reference in New Issue
Block a user