Add WebAssembly info

Author: ThomasFarstrike

docs/getting-started/running.md

@@ -1,6 +1,6 @@
 # Running it
 
-MicroPythonOS can run on supported microcontrollers (e.g., ESP32) and on desktop systems (Linux, Raspberry Pi, MacOS, Windows etc).
+MicroPythonOS can run on supported microcontrollers (e.g., ESP32), on desktop systems (Linux, Raspberry Pi, MacOS, Windows), and in a web browser via WebAssembly.
 
 To install prebuilt software, read on!
 
@@ -18,6 +18,12 @@ On desktop you can choose how deep you want to go: run a pre-built binary, devel
 
 See [Running on Desktop](../os-development/running-on-desktop.md) for detailed steps.
 
+## Running in the browser
+
+Open **[web.micropythonos.com](https://web.micropythonos.com/)** for the latest release, or **[micropythonos.github.io/MicroPythonOS](https://micropythonos.github.io/MicroPythonOS/)** for the bleeding-edge main branch. No install required.
+
+See [Using the Web Port](../web-port/using.md) for details and limitations.
+
 ## Next Steps
 
 - Explore [Built-in Apps](../apps/built-in-apps.md) to get started with the system.

docs/getting-started/supported-hardware.md

@@ -23,6 +23,14 @@ MicroPythonOS runs on a variety of platforms, from microcontrollers to desktops.
 - [SQUiXL](https://squixl.io): Fully Supported
 - [Waveshare ESP32-S3-Touch-LCD-2](https://www.waveshare.com/wiki/ESP32-S3-Touch-LCD-2): Fully Supported
 
+## WebAssembly (Browser)
+
+- **Latest release**: [web.micropythonos.com](https://web.micropythonos.com/)
+- **Main branch CI**: [micropythonos.github.io/MicroPythonOS](https://micropythonos.github.io/MicroPythonOS/)
+- Runs entirely in a modern desktop browser — no install, no flash.
+- Built from source with `./scripts/build_mpos.sh web` (requires [Emscripten SDK](../web-port/developer/#prerequisites)).
+- See [CI config](https://github.com/MicroPythonOS/MicroPythonOS/blob/main/.github/workflows/web-pages.yml) for automated build details.
+
 ## Desktop Computers
 
 - **Linux**: Supported using SDL for display handling.

docs/os-development/compiling.md

@@ -32,7 +32,7 @@ Usage:
 ./scripts/build_mpos.sh <target system>
 ```
 
-**Target systems**: `esp32`, `esp32s3`, `unix` (= Linux) and `macOS`
+**Target systems**: `esp32`, `esp32s3`, `unix` (= Linux), `macOS` and `web` (= WebAssembly)
 
 **Examples**:
 

docs/web-port/using.md

@@ -15,9 +15,11 @@ Open that link in a modern desktop browser and the OS will boot directly into th
 The web port stores writable data (`/data` and `/apps`) in the browser's IndexedDB. The read-only system files are baked into the WebAssembly preload. If you want a completely clean start — for example, after a major upstream change or to clear stale app data — you need to wipe the stored filesystem:
 
 1. Open the developer tools (`F12`).
-2. Go to **Application** → **Storage** → **Local Storage / IndexedDB** (or the equivalent in your browser).
-3. Clear site data / delete everything for `micropythonos.github.io`.
-4. Close the tab or press `F5` to reload the page.
+2. Go to **Application** → **Storage** (Chromium) or **Storage** → **IndexedDB** (Firefox).
+3. Clear site data for the origin (e.g. `micropythonos.github.io` or `web.micropythonos.com`).
+4. Reload the page.
+
+Alternatively, you can update installed apps through the built-in App Store without clearing storage.
 
 After the reload the OS will boot with a fresh filesystem. The bundled demo apps will be re-seeded on first run.