-A Tauri 2.0 desktop application that wraps [operatoruplift.com](https://www.operatoruplift.com) in a native window.
+
-The website includes 38 pages, a full dashboard, real LLM chat, swarm orchestration, and a memory engine. This Tauri shell provides a native desktop experience around the production site.
+
-## Features
+
+
+
+
+
+
+
+
+
+
+
+
+
+
The desktop and Android shells from Operator Uplift's AI-assistant era.
+
+
+
+**webview holds the two app shells Operator Uplift used to put operatoruplift.com on a desktop and a phone.** The desktop shell is a Tauri 2 app in Rust that opens the site in a native window, with a tray menu and an offline page. The Android shell is a single WebView Activity that loads the site and sends other hosts to the browser. Neither shell contains product code, and neither has changed since 1 April 2026, seven weeks before the 22 May 2026 pivot to commitment infrastructure. The Android app Operator Uplift ships today is built from the private website repository instead.
+
+The window in the banner is the desktop shell's built-in offline page, rendered from the HTML in `src-tauri/src/main.rs` on 30 October 2026. Online, the same window shows operatoruplift.com itself.
+
+The Android project began as slymax's WebView template for Android Studio, and its history from 2020 to 2022 is kept here, which is why GitHub still calls this repo a template. It was pointed at operatoruplift.com on 20 January 2026, and the Tauri shell arrived on 1 April 2026 in [pull request 1](https://github.com/operatoruplift/webview/pull/1).
+
+
+
+## How it works
+
+
+
+
+
+
+
+
+
No white flash The window starts hidden on a #050508 background, tries a TCP connection to www.operatoruplift.com:443 for up to five seconds, then shows itself 300 ms later.
+
An offline page, not an error If that check fails, the shell opens about:blank and writes its own No Connection page, whose Retry button reloads the site.
+
Desktop detection After the check, the shell runs window.__TAURI__ = true in the page, so the site can tell it is inside the desktop app.
+
+
+
A tray icon Open shows and focuses the window, Quit Operator Uplift exits, and clicking the icon restores the window.
+
macOS manners Closing the window, with Cmd+W or the close button, hides it instead of quitting. Cmd+Q in the default app menu, or Quit in the tray, exits.
+
Android navigation JavaScript is on, Back walks the WebView history, and a link to any host outside operatoruplift.com opens in the default browser.
+
+
+
+
Tauri 2.10 · Rust 2021 edition · tokio · tauri-plugin-shell · Android WebView in Java · Android Gradle Plugin 8.7.3 · Gradle 8.10.2 · compile and target SDK 34, minimum SDK 21 · GitHub Actions with JDK 17
+
+
+
+## Status
+
+
+
+
+
The Tauri desktop shell. Until 30 October 2026 it did not compile: main.rs passed a WebviewUrl where Tauri 2 expects a Url. With that fixed, cargo check --locked passes (checked on Linux with stub pkg-config entries for GTK and WebKitGTK, so the code was type-checked but not linked or run). No installer has been built, signed or released, and the planned second phase, connecting to the core runtime on localhost:3001, was never started.
The Android shell. The Build Android APK workflow passed on its last run, on 1 April 2026, and its APK has since expired. Each run signs with a keystore generated in that run, so the APKs suit testing, not a store. The app still carries the template's name, WebView App, and its green globe icon.
+
+
+
+## Where it fit
+
+Operator Uplift was first pitched as AI for your inbox and calendar, built across several repos. This one put the website on desktops and phones.
+
+
+
+
Repo
+
Role in the AI-assistant platform
+
+
+
webview (this repo)
+
The Tauri desktop shell and an Android WebView shell, both loading operatoruplift.com.
Prerequisites Rust stable (checked with 1.97.0) and the Tauri 2 CLI. On Linux, the WebKitGTK 4.1 and GTK 3 development packages. For Android, JDK 17 and an Android SDK with platform 34.
What the checks prove There are no tests. The APK workflow proves the Android project assembles. Nothing in CI builds the desktop shell; cargo check is the only check it has had.
+
+
+
+### 1. The desktop shell
-- **Native window** — 1280x800 default, 900x600 minimum, dark theme (#050508)
-- **System tray** — Open / Quit menu, click to restore
-- **macOS integration** — Cmd+W hides to tray, Cmd+Q quits
-- **Desktop detection** — Injects `window.__TAURI__ = true`
-- **No white flash** — Window starts hidden, shown after content loads
-- **Offline fallback** — Shows "No Connection" page when offline
-- **Cross-platform bundles** — macOS .dmg, Windows .exe (NSIS), Linux .AppImage
+```bash
+cargo install tauri-cli --version "^2" # the Tauri 2 CLI
+cargo tauri dev # opens the window on https://www.operatoruplift.com
+cargo tauri build # installers in src-tauri/target/release/bundle/
+```
+
+There is no local frontend: `devUrl` and the window URL both point at the live site, and `dist/index.html` only redirects there. Bundle targets are set to `all`, so a build makes every bundle format Tauri supports on your OS, such as a .dmg on macOS, an NSIS installer on Windows or an .AppImage on Linux.
-## Prerequisites
+To type-check without building, run `cargo check --manifest-path src-tauri/Cargo.toml --locked`.
-- [Rust](https://rustup.rs/) (stable)
-- [Tauri CLI](https://v2.tauri.app/start/prerequisites/) v2
+### 2. The Android shell
```bash
-cargo install tauri-cli --version "^2"
+./gradlew assembleDebug # a debug APK in app/build/outputs/apk/debug/
```
-## Development
+The [workflow](.github/workflows/build-apk.yml) builds a signed release instead. On every push to `master`, or when run by hand, it generates `release.keystore` with `keytool`, sets the variables below and runs `./gradlew assembleRelease`.
-```bash
-cargo tauri dev
-```
+| Variable | Default in `app/build.gradle` | Used for |
+|---|---|---|
+| `KEYSTORE_FILE` | `release.keystore`, relative to `app/` | The release keystore |
+| `KEYSTORE_PASSWORD` | `android` | The keystore password |
+| `KEY_ALIAS` | `key0` | The key alias |
+| `KEY_PASSWORD` | `android` | The key password |
-## Build
+
+Pointing the shells at another site
+
-```bash
-cargo tauri build
-```
+| File | What to change |
+|---|---|
+| `src-tauri/tauri.conf.json` | `build.devUrl`, `app.windows[0].url` and `bundle.macOS.exceptionDomain` |
+| `src-tauri/src/main.rs` | The host in `check_connectivity` and the text of `OFFLINE_HTML` |
+| `dist/index.html` | The redirect target |
+| `app/src/main/java/com/example/app/MainActivity.java` | The URL in `mWebView.loadUrl(...)` |
+| `app/src/main/java/com/example/app/MyWebViewClient.java` | `hostname`, which decides which links stay in the app |
+
+To ship local files on Android instead, put them in `app/src/main/assets/` and switch `MainActivity` to the commented `file:///android_asset/index.html` line.
+
+
+
+
+Repository layout
+
-Output bundles are in `src-tauri/target/release/bundle/`.
+| Path | Contents |
+|---|---|
+| `src-tauri/src/main.rs` | The desktop shell: tray, connection check, offline page and window events |
+| `src-tauri/tauri.conf.json` | Window size and color, the site URL, bundle targets and icons |
+| `src-tauri/capabilities/default.json` | Permissions for the main window: `core:default` and `shell:allow-open` |
+| `dist/index.html` | The bundled fallback page, which redirects to the site |
+| `app/` | The Android app: `MainActivity`, `MyWebViewClient`, the manifest and resources |
+| `build.gradle`, `settings.gradle`, `gradle/`, `gradlew` | The Gradle build for the Android app |
+| `.github/workflows/build-apk.yml` | Builds a signed release APK |
+| `CLAUDE.md` | The brief the desktop shell was built from |
-## Roadmap
+
-- **Phase 1** (current): Load production URL in webview
-- **Phase 2**: Connect to CORE runtime at `localhost:3001`
+
-## License
+
MIT licensed, copyright 2026 Operator Uplift (see LICENSE); dependencies keep their own licenses.
diff --git a/docs/readme/banner.png b/docs/readme/banner.png
new file mode 100644
index 0000000..e0a3e8d
Binary files /dev/null and b/docs/readme/banner.png differ
diff --git a/docs/readme/flow-dark.png b/docs/readme/flow-dark.png
new file mode 100644
index 0000000..f8da0f4
Binary files /dev/null and b/docs/readme/flow-dark.png differ
diff --git a/docs/readme/flow-light.png b/docs/readme/flow-light.png
new file mode 100644
index 0000000..11a4efc
Binary files /dev/null and b/docs/readme/flow-light.png differ
diff --git a/src-tauri/src/main.rs b/src-tauri/src/main.rs
index 7e06da9..18e7cd5 100644
--- a/src-tauri/src/main.rs
+++ b/src-tauri/src/main.rs
@@ -4,7 +4,7 @@
use tauri::{
menu::{Menu, MenuItem, PredefinedMenuItem},
tray::TrayIconBuilder,
- Emitter, Manager, RunEvent, WebviewUrl, WindowEvent,
+ Manager, RunEvent, WindowEvent,
};
/// Offline fallback HTML shown when operatoruplift.com is unreachable.
@@ -98,9 +98,9 @@ fn main() {
let online = check_connectivity().await;
if let Some(window) = handle.get_webview_window("main") {
if !online {
- // Navigate to data URI with offline page
+ // Navigate to a blank page, then write the offline page into it
let _ = window.navigate(
- WebviewUrl::App("about:blank".into()).into(),
+ tauri::Url::parse("about:blank").expect("about:blank is a valid URL"),
);
// Small delay so navigation starts
tokio::time::sleep(std::time::Duration::from_millis(100)).await;