wiki/Home.md

63 lines · Markdown
1# SophaxChat
2
3**Anonymous · Offline · End-to-end encrypted mesh chat**
4
5Works over Bluetooth LE and WiFi Direct — no internet, no servers, no account.  
6Reach anyone globally by routing through Tor (via Orbot).  
7Your identity is a Curve25519 key pair generated on your device. Nothing is ever sent to a server.
8
9---
10
11## Quick start
12
13### iOS / macOS
14
15```bash
16brew install xcodegen
17git clone https://github.com/richardmetzner/SophaxChat
18cd SophaxChat
19xcodegen generate
20open SophaxChat.xcodeproj   # then ⌘R on a physical device
21```
22
23> Physical device required — MultipeerConnectivity (BLE/WiFi P2P) does not work in Simulator.
24
25**Mac (no Apple Developer account needed):**  
26Select *My Mac (Designed for iPad)* as the run destination.
27
28### Android
29
30```bash
31cd android
32./gradlew assembleDebug
33adb install app/build/outputs/apk/debug/app-debug.apk
34```
35
36See [`android/README.md`](https://github.com/richardmetzner/SophaxChat/blob/main/android/README.md) for full instructions.
37
38---
39
40## Wiki pages
41
42| Page | Contents |
43|---|---|
44| [[Protocol]] | Wire message format, session lifecycle, relay routing |
45| [[Cryptography]] | Key types, X3DH, Double Ratchet, Header Encryption, Sealed Sender |
46
47---
48
49## Key links
50
51- [README](https://github.com/richardmetzner/SophaxChat#readme) — full feature list, architecture, getting started
52- [SECURITY.md](https://github.com/richardmetzner/SophaxChat/blob/main/SECURITY.md) — threat model, responsible disclosure
53- [CONTRIBUTING.md](https://github.com/richardmetzner/SophaxChat/blob/main/.github/CONTRIBUTING.md) — how to contribute
54- [CHANGELOG](https://github.com/richardmetzner/SophaxChat/blob/main/CHANGELOG.md) — release history
55- [Open issues](https://github.com/richardmetzner/SophaxChat/issues)
56
57---
58
59## Philosophy
60
611. **No servers.** Every feature works peer-to-peer.
622. **No identity leakage.** No phone number, no email, no account.
633. **Maximum cryptographic protection.** X3DH + Double Ratchet + Header Encryption + Sealed Sender — not features, the baseline.