From 82936cc04c7ffd3036c889aa1f0fa517af4767c5 Mon Sep 17 00:00:00 2001
From: commander <danny@gositeme.com>
Date: Tue, 7 Apr 2026 16:16:25 -0400
Subject: [PATCH] Add comprehensive README with architecture docs

---
 README.md | 41 +++++++++++++++++++++++++++++++++++++++--
 1 file changed, 39 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index da8d782..055caef 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,40 @@
-# alfred-browser
+# Alfred Browser
 
-Privacy-first Chromium fork with Kyber-1024, ad blocking, anti-fingerprinting.
\ No newline at end of file
+Privacy-first web browser built on Electron with post-quantum encryption, WebTorrent P2P distribution, and AI integration.
+
+## Features
+
+- **Post-quantum encryption**: Kyber-1024 (ML-KEM-1024) key exchange
+- **MAC randomization**: Per-session hardware address rotation
+- **Built-in P2P**: WebTorrent-enabled for decentralized content delivery
+- **AI tools**: 500+ MCP tools accessible from browser context
+- **Cross-platform**: Linux (.deb, .rpm, .AppImage), Windows (portable .zip), macOS (Intel + Apple Silicon), Android (.apk)
+
+## Build Artifacts
+
+| Platform | Format | Size |
+|----------|--------|------|
+| Linux x64 | AppImage | 159 MB |
+| Linux x64 | .deb | 113 MB |
+| Linux x64 | .rpm | 115 MB |
+| Windows x64 | .zip | 167 MB |
+| macOS Intel | .zip | 154 MB |
+| macOS ARM64 | .zip | 148 MB |
+| Android | .apk | 89 MB |
+
+## Architecture
+
+Built with Electron + Chromium. Custom preload scripts inject:
+- Post-quantum TLS negotiation
+- MAC address cycling on network change
+- WebTorrent client for P2P downloads
+- Sovereign DNS resolution via Handshake (HSD)
+
+## Downloads
+
+- [alfredlinux.com/apps](https://alfredlinux.com/apps)
+- [gositeme.com/apps](https://gositeme.com/apps)
+
+## License
+
+AGPL-3.0 — GoSiteMe Inc.