diff --git a/README.md b/README.md
index 97229d5..dec46ce 100644
--- a/README.md
+++ b/README.md
@@ -32,18 +32,30 @@ npm install
 
 ## Run
 
-Two terminals:
+Single command — starts both servers, cleans up on Ctrl+C:
 
 ```bash
-# Terminal 1 — backend on http://localhost:8000
-cd backend 
-uv run uvicorn main:app --reload
-
-# Terminal 2 — frontend on http://localhost:5173 (proxies /api → :8000)
-cd frontend
-npm run dev
+./dev.sh
 ```
 
+| Server   | URL                       |
+|----------|---------------------------|
+| Backend  | http://localhost:8000     |
+| Frontend | http://localhost:5173     |
+
+Or manually in two terminals:
+
+```bash
+# Terminal 1 — backend
+cd backend && uv run uvicorn main:app --reload --host 0.0.0.0
+
+# Terminal 2 — frontend (exposed on LAN for phone testing)
+cd frontend && npm run dev:host
+```
+
+The SQLite database (`backend/calcount.db`) is created and migrated
+automatically on backend startup (`backend/migrations/`).
+
 The SQLite database (`backend/calcount.db`) is created and migrated
 automatically on backend startup (`backend/migrations/`).
 
@@ -61,4 +73,11 @@ cd frontend && npm run build       # production build to frontend/dist/
 ```
 
 # Agentic dev
-Defined subagents, idea is big strong agent tells the little ones what to do. I maybe have overkilled on the "small" agents, v4 pro is till pretty powerful. Play around with it and see what we can get away with. 
\ No newline at end of file
+Defined subagents, idea is big strong agent tells the little ones what to do. I maybe have overkilled on the "small" agents, v4 pro is till pretty powerful. Play around with it and see what we can get away with. 
+
+
+# Future enhancements
+ - fully offline JS version (new project built out of this, i have some notes on this somewhere)
+ - download and use https://world.openfoodfacts.org/data
+ - have this version work offline (pwa or local storage or something)
+ - 
\ No newline at end of file