docs: document --target web (WebAssembly) build alongside native targets

- README.md: add web/WASM to the cross-platform list and a "Run in the
  browser" section with the build/serve commands and a brief description
  of what degrades on web (SQLite → in-memory transient store, Hone code
  editor's native FFI → no-op, MongoDB driver → needs Mango Server proxy).
- CLAUDE.md:
  * Project Overview now mentions the self-contained HTML+WASM build.
  * Commands section adds the perry compile --target web invocation
    and python3 -m http.server (file:// hits CORS).
  * New "Web Target Notes" section explaining what __platform__ === 5
    triggers in the source: connection-store falls back to webTransient,
    Keychain → localStorage, Hone editor degrades, MongoDB needs a proxy,
    and CORS swallows telemetry from non-whitelisted origins.

Mango compiles cleanly with Perry 0.4.65's WASM target and renders its
welcome screen ("Welcome to Mango" + "+ New Connection") matching the
native app.

Author: proggeramlug

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-Mango is a native desktop MongoDB GUI built with Perry (TypeScript-to-native compiler). It produces ~7 MB cross-platform binaries targeting macOS (AppKit), iOS (UIKit), Android (Views), Linux (GTK4), and Windows (Win32) from a single TypeScript codebase.
+Mango is a native MongoDB GUI built with Perry (TypeScript-to-native compiler). It produces ~7 MB cross-platform binaries targeting macOS (AppKit), iOS (UIKit), Android (Views), Linux (GTK4), and Windows (Win32) from a single TypeScript codebase. It also compiles to a single self-contained HTML+WebAssembly file via `--target web` for in-browser use.
 
 ## Commands
 
@@ -21,6 +21,12 @@ npm run build:macos      # Platform-specific builds
 npm run build:linux
 npm run build:windows
 
+# Web (WebAssembly + DOM bridge in a single self-contained HTML file)
+perry compile src/app.ts --target web -o dist/mango.html
+# Serve over HTTP so fetch() works (file:// hits CORS)
+python3 -m http.server 8765 -d dist
+open http://localhost:8765/mango.html
+
 # Testing (uses Bun, not Node)
 npm test                 # All tests
 npm run test:unit        # Unit tests only
@@ -44,8 +50,21 @@ bun test tests/connection-store.test.ts  # Run a single test file
 
 ## Key Conventions
 
-- **Perry, not Electron:** UI uses Perry's native bindings, not DOM/HTML. No `document`, `window`, or CSS — use Perry widget types and RGBA colors.
+- **Perry, not Electron:** UI uses Perry's native bindings, not DOM/HTML. No `document`, `window`, or CSS — use Perry widget types and RGBA colors. (On the `--target web` build, Perry's WASM runtime maps every widget to a DOM element under the hood, but the source code stays the same — you never write HTML.)
 - **Path alias:** `@/*` maps to `src/*` in imports.
 - **External editor widget:** `@honeide/editor` is a local dependency (`file:../hone/hone-editor`) used for document editing.
 - **Test mocks:** Perry APIs and MongoDB are mocked in `tests/mocks/`. Tests preload `tests/preload.ts` via bunfig.toml. Use `reset-database.ts` to clear state between tests.
 - **Connection URI building:** `ConnectionStore.buildConnectionUri()` handles auth mechanisms (SCRAM-SHA-256, etc.) and TLS options. Always use this rather than constructing URIs manually.
+
+## Web Target Notes
+
+`perry compile src/app.ts --target web` produces a single ~4 MB self-contained HTML file with the WebAssembly binary, the JS bridge for DOM widgets, and all string/data sections embedded. It's the same backend as `--target wasm`; both flags produce identical output.
+
+Platform branches with `__platform__ === 5` cover the web case:
+
+- **Connection storage**: `connection-store.ts` falls back to an in-memory `webTransient` store on web instead of SQLite (which doesn't compile to WASM). Connection profiles are not persisted across reloads in the browser.
+- **Keychain**: maps to `localStorage` (Perry's web bridge). Fine for connection metadata but **not** for production secrets — anything in localStorage is readable by other scripts in the same origin.
+- **Hone code editor**: requires native FFI (`hone_editor_*`) that has no browser implementation. Perry's WASM bridge auto-stubs these to no-ops via a `Proxy`, so the editor area shows up but key/mouse handling is inactive. Document editing works with the plain `<textarea>` fallback.
+- **MongoDB driver**: native MongoDB doesn't run in the browser. The web build needs to talk to a Mango Server proxy (`web-mongo-client.ts` over `fetch`). For local testing, run mongod + mango-server alongside the served HTML and update the connection string.
+- **fetch / CORS**: any third-party URL (telemetry, public APIs) must allow your origin. Mango's `trackEvent` will silently fail with a CORS error from `file://` and from origins not whitelisted by `api.chirp247.com` — this is expected and the catch in `trackEvent` swallows it.
+- **Serving**: must be served over HTTP, not opened directly via `file://` (browsers reject `fetch()` from file URLs). Any static server works (`python3 -m http.server`, `npx serve`, etc.).

README.md

@@ -31,7 +31,7 @@ Mango is a native desktop MongoDB client written in TypeScript and compiled to n
 - **Document CRUD** — Insert, update, delete, and duplicate documents.
 - **Index listing** — View indexes with key, uniqueness, and size info.
 - **Dark & light mode** — Follows system preference automatically.
-- **Cross-platform** — Targets macOS (AppKit), iOS (UIKit), Android (Views), Linux (GTK4), and Windows (Win32).
+- **Cross-platform** — Targets macOS (AppKit), iOS (UIKit), Android (Views), Linux (GTK4), Windows (Win32), and the **browser** (WebAssembly + DOM via Perry's `--target web`).
 
 ## Getting Started
 
@@ -54,6 +54,19 @@ perry compile src/app.ts --output mango
 ./mango
 ```
 
+### Run in the browser (WebAssembly)
+
+```bash
+# Compile to a single self-contained HTML+WASM file (~4 MB)
+perry compile src/app.ts --target web -o dist/mango.html
+
+# Serve over HTTP (file:// won't work — fetch() hits CORS errors)
+python3 -m http.server 8765 -d dist
+open http://localhost:8765/mango.html
+```
+
+The web build is the same source code, compiled by Perry to WebAssembly with a JavaScript bridge that maps every Perry widget to a DOM element. SQLite-backed connection storage degrades to an in-memory transient store on web; the Hone code editor's native bindings degrade to no-ops; and you'll need to point at a Mango Server proxy if you want to talk to MongoDB from the browser. Everything else (UI, navigation, query builder, document viewer, dark/light mode, i18n) works the same as the native builds.
+
 ### Development
 
 ```bash