diff --git a/README.md b/README.md
index a19f26d..7bfa7b8 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,24 @@
-# sovereign-stack-pwa
+# Sovereign Stack PWA
 
-Sovereign Stack PWA — local-first offline-capable encrypted vault + Lightning/L402 client + open-weight LLM bridge. MIT.
\ No newline at end of file
+Local-first, Lightning-native PWA for sovereign computing. Offline-capable encrypted vault, L402 payments, open-weight LLM bridge.
+
+## Install
+```bash
+git clone https://forge.alexanderwhitestone.com/git/stackchain/sovereign-stack-pwa.git
+cd sovereign-stack-pwa
+bash install.sh
+```
+
+## Run
+```bash
+cd ~/sovereign-stack-pwa
+python3 -m http.server 8080
+# Visit http://localhost:8080 on any device
+```
+
+## Stack
+- PWA shell with offline service worker
+- Encrypted vault using IndexedDB
+- Lightning / L402 payment module (planned)
+- Ollama bridge for local open-weight LLMs (planned)
+- MIT license. No black boxes.