diff --git a/README.md b/README.md index 5ed9b87..c228848 100755 --- a/README.md +++ b/README.md @@ -1,47 +1,195 @@ -# Operator Uplift Desktop +
-A Tauri 2.0 desktop application that wraps [operatoruplift.com](https://www.operatoruplift.com) in a native window. +webview, marked Superseded. Tauri 2, Android, Rust. operatoruplift.com in a native window. A Tauri 2 desktop shell and an Android WebView shell that load operatoruplift.com, built in early 2026 for the AI-assistant era. Tauri 2, Android WebView, tray and offline page, APK built in CI. cargo tauri dev. Beside it, a window titled Operator Uplift shows the shell's own offline page: No Connection, Unable to reach operatoruplift.com, and a Retry button. -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 +Run the shells   +Open the APK workflow   +Operator Uplift today + +

+ +Build Android APK workflow status +Status: superseded +Tauri 2.10 +Rust 2021 edition +Android SDK 21 to 34 +License: MIT + +

The desktop and Android shells from Operator Uplift's AI-assistant era.

+ +Launch  →  Check  →  Load  →  Show + +
+ +How it works  ·  +Status  ·  +Where it fit  ·  +Run it locally + +
+ +
+ +**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 + + + + Desktop shell, Tauri 2 and Rust: a 1280x800 window, shown after a connection check; a tray menu with Open and Quit; a built-in No Connection page. The website, operatoruplift.com: every screen comes from the live site; no copy of the app ships in either shell; since May 2026 it serves the commitment app. Android shell, WebView and Java: one Activity with a full-screen WebView; Back walks the WebView history; other hosts open in the browser. Both shells load the website. + + + + + + + + + + + + + +
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 + + + + + + + + + + + + +
SupersededThe 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.main.rs
SupersededThe 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.Last APK run
+ +
+ +## 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. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
RepoRole in the AI-assistant platform
webview (this repo)The Tauri desktop shell and an Android WebView shell, both loading operatoruplift.com.
UIShared React components and design tokens. Before April 2026, the Uplift Assistant Electron desktop app.
developer_console (private)A Vite and React console for agent builders: prompt playground, debugger, logs, memory and MCP pages.
core (private)The agent runtime that the console and this desktop shell were meant to reach on localhost:3001.
calendar_agent, x402-agent, project_space (private)Google Calendar tools, x402 agent payments on Solana, and an internal project tracker.
uplift-ai-chatbotA deployment of Vercel's Chat SDK template.
+ +
+ +## Run it locally + + + + + + + +
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.
Read first
The Tauri prerequisites for your OS, and CLAUDE.md, the brief the desktop shell was built from.
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.

-[MIT](LICENSE) — Copyright (c) 2026 Operator Uplift +

Built by Matt Sim, founder of Operator Uplift. More builds at github.com/operatoruplift. Want one built for your product? Book a 15-minute call.

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;