Skip to content
This repository was archived by the owner on Nov 1, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
206 changes: 177 additions & 29 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,47 +1,195 @@
# Operator Uplift Desktop
<div align="center">

A Tauri 2.0 desktop application that wraps [operatoruplift.com](https://www.operatoruplift.com) in a native window.
<img src="docs/readme/banner.png" alt="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." width="100%">

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.
<br><br>

## Features
<a href="#run-it-locally"><img src="https://img.shields.io/badge/Run_the_shells-FF8C00?style=for-the-badge" alt="Run the shells" height="36"></a>&nbsp;&nbsp;
<a href="https://github.com/operatoruplift/webview/actions/workflows/build-apk.yml"><img src="https://img.shields.io/badge/APK_workflow-1F1F23?style=for-the-badge" alt="Open the APK workflow" height="36"></a>&nbsp;&nbsp;
<a href="https://operatoruplift.com"><img src="https://img.shields.io/badge/Operator_Uplift_today-536079?style=for-the-badge" alt="Operator Uplift today" height="36"></a>

<br><br>

<a href="https://github.com/operatoruplift/webview/actions/workflows/build-apk.yml"><img src="https://github.com/operatoruplift/webview/actions/workflows/build-apk.yml/badge.svg?branch=master" alt="Build Android APK workflow status"></a>
<img src="https://img.shields.io/badge/status-superseded-536079?style=flat-square&labelColor=1F1F23" alt="Status: superseded">
<img src="https://img.shields.io/badge/Tauri-2.10-FF8C00?style=flat-square&logo=tauri&logoColor=white&labelColor=1F1F23" alt="Tauri 2.10">
<img src="https://img.shields.io/badge/Rust-2021_edition-6F6163?style=flat-square&logo=rust&logoColor=white&labelColor=1F1F23" alt="Rust 2021 edition">
<img src="https://img.shields.io/badge/Android-SDK_21_to_34-34D399?style=flat-square&logo=android&logoColor=white&labelColor=1F1F23" alt="Android SDK 21 to 34">
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-6F6163?style=flat-square&labelColor=1F1F23" alt="License: MIT"></a>

<h3>The desktop and Android shells from Operator Uplift's AI-assistant era.</h3>

<b>Launch</b> &nbsp;→&nbsp; <b>Check</b> &nbsp;→&nbsp; <b>Load</b> &nbsp;→&nbsp; <b>Show</b>

<br>

<a href="#how-it-works">How it works</a> &nbsp;·&nbsp;
<a href="#status">Status</a> &nbsp;·&nbsp;
<a href="#where-it-fit">Where it fit</a> &nbsp;·&nbsp;
<a href="#run-it-locally">Run it locally</a>

</div>

<br>

**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).

<br>

## How it works

<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/readme/flow-dark.png">
<img src="docs/readme/flow-light.png" alt="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." width="100%">
</picture>

<table>
<tr valign="top">
<td width="33%"><b>No white flash</b><br><sub>The window starts hidden on a <code>#050508</code> background, tries a TCP connection to <code>www.operatoruplift.com:443</code> for up to five seconds, then shows itself 300 ms later.</sub></td>
<td width="33%"><b>An offline page, not an error</b><br><sub>If that check fails, the shell opens <code>about:blank</code> and writes its own No Connection page, whose Retry button reloads the site.</sub></td>
<td width="33%"><b>Desktop detection</b><br><sub>After the check, the shell runs <code>window.__TAURI__ = true</code> in the page, so the site can tell it is inside the desktop app.</sub></td>
</tr>
<tr valign="top">
<td><b>A tray icon</b><br><sub>Open shows and focuses the window, Quit Operator Uplift exits, and clicking the icon restores the window.</sub></td>
<td><b>macOS manners</b><br><sub>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.</sub></td>
<td><b>Android navigation</b><br><sub>JavaScript is on, Back walks the WebView history, and a link to any host outside operatoruplift.com opens in the default browser.</sub></td>
</tr>
</table>

<p align="center"><sub>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</sub></p>

<br>

## Status

<table>
<tr valign="top">
<td width="16%" align="center"><img src="https://img.shields.io/badge/SUPERSEDED-536079?style=for-the-badge" alt="Superseded"></td>
<td>The Tauri desktop shell. Until 30 October 2026 it did not compile: <code>main.rs</code> passed a <code>WebviewUrl</code> where Tauri 2 expects a <code>Url</code>. With that fixed, <code>cargo check --locked</code> passes (checked on Linux with stub <code>pkg-config</code> 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 <code>localhost:3001</code>, was never started.</td>
<td width="22%"><a href="src-tauri/src/main.rs">main.rs</a></td>
</tr>
<tr valign="top">
<td align="center"><img src="https://img.shields.io/badge/SUPERSEDED-536079?style=for-the-badge" alt="Superseded"></td>
<td>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.</td>
<td><a href="https://github.com/operatoruplift/webview/actions/runs/23857839292">Last APK run</a></td>
</tr>
</table>

<br>

## 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.

<table>
<tr>
<th width="30%" align="left">Repo</th>
<th width="70%" align="left">Role in the AI-assistant platform</th>
</tr>
<tr valign="top">
<td><b>webview</b> (this repo)</td>
<td>The Tauri desktop shell and an Android WebView shell, both loading operatoruplift.com.</td>
</tr>
<tr valign="top">
<td><a href="https://github.com/operatoruplift/UI"><b>UI</b></a></td>
<td>Shared React components and design tokens. Before April 2026, the Uplift Assistant Electron desktop app.</td>
</tr>
<tr valign="top">
<td><b>developer_console</b> (private)</td>
<td>A Vite and React console for agent builders: prompt playground, debugger, logs, memory and MCP pages.</td>
</tr>
<tr valign="top">
<td><b>core</b> (private)</td>
<td>The agent runtime that the console and this desktop shell were meant to reach on <code>localhost:3001</code>.</td>
</tr>
<tr valign="top">
<td><b>calendar_agent</b>, <b>x402-agent</b>, <b>project_space</b> (private)</td>
<td>Google Calendar tools, x402 agent payments on Solana, and an internal project tracker.</td>
</tr>
<tr valign="top">
<td><a href="https://github.com/operatoruplift/uplift-ai-chatbot"><b>uplift-ai-chatbot</b></a></td>
<td>A deployment of Vercel's Chat SDK template.</td>
</tr>
</table>

<br>

## Run it locally

<table>
<tr valign="top">
<td width="33%"><b>Prerequisites</b><br><sub>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.</sub></td>
<td width="33%"><b>Read first</b><br><sub>The <a href="https://v2.tauri.app/start/prerequisites/">Tauri prerequisites</a> for your OS, and <a href="CLAUDE.md">CLAUDE.md</a>, the brief the desktop shell was built from.</sub></td>
<td width="33%"><b>What the checks prove</b><br><sub>There are no tests. The APK workflow proves the Android project assembles. Nothing in CI builds the desktop shell; <code>cargo check</code> is the only check it has had.</sub></td>
</tr>
</table>

### 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
<details>
<summary><b>Pointing the shells at another site</b></summary>
<br>

```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.

</details>

<details>
<summary><b>Repository layout</b></summary>
<br>

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
</details>

- **Phase 1** (current): Load production URL in webview
- **Phase 2**: Connect to CORE runtime at `localhost:3001`
<br>

## License
<p align="center"><sub>MIT licensed, copyright 2026 Operator Uplift (see <a href="LICENSE">LICENSE</a>); dependencies keep their own licenses.</sub></p>

[MIT](LICENSE) — Copyright (c) 2026 Operator Uplift
<p align="center"><sub>Built by <a href="https://rvaclassic.xyz">Matt Sim</a>, founder of <a href="https://operatoruplift.com">Operator Uplift</a>. More builds at <a href="https://github.com/operatoruplift">github.com/operatoruplift</a>. Want one built for your product? <a href="https://cal.com/rvaclassic/15min">Book a 15-minute call</a>.</sub></p>
Binary file added docs/readme/banner.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/readme/flow-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/readme/flow-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions src-tauri/src/main.rs
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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;
Expand Down