Skip to content
This repository was archived by the owner on Nov 1, 2026. It is now read-only.

Redesign the README and fix the desktop shell's compile error - #2

Merged
operatoruplift merged 2 commits into
masterfrom
claude/readme-redesign
Oct 31, 2026
Merged

operatoruplift merged 2 commits into
masterfrom
claude/readme-redesign

Conversation

@operatoruplift

Copy link
Copy Markdown
Owner

What changed

The old README described only the Tauri shell, repeated website claims that have since been retired, and said nothing about the Android app that makes up most of the repo. GitHub's description ("a template project for android studio") is inherited from the WebView template the Android half started from. This rebuilds the README in the same house style as the pilot (allowance) and fixes a compile error in the desktop shell.

  • Header: banner showing the desktop shell's own offline page (its HTML from main.rs, rendered locally), buttons for running the shells, the APK workflow and Operator Uplift today, the workflow badge and stack badges, and the Launch → Check → Load → Show loop.
  • How it works: a flow card (desktop shell, the website, Android shell, light and dark) and six behaviors read from the code: no white flash, the offline page, desktop detection, the tray, macOS close and quit, and Android navigation.
  • Status: both shells SUPERSEDED, with what was and was not verified.
  • Where it fit: the platform this repo belonged to, described the same way across this redesign.
  • Run it locally: the Tauri commands from the old README, plus the Android build, the workflow's signing variables, how to point the shells at another site, and the repository layout.

Corrections to the old README

  • Removed "38 pages, a full dashboard, real LLM chat, swarm orchestration, and a memory engine". Those described the AI-assistant website, which was retired at the 22 May 2026 pivot; the shells load whatever operatoruplift.com serves now.
  • "Window starts hidden, shown after content loads" is now what the code does: it shows after a five-second-capped connection check and a 300 ms delay.
  • The Phase 2 roadmap item (connect to the core runtime on localhost:3001) moved to Status as never started.
  • Added the Android shell, its workflow and its signing variables, which were undocumented.

Fix

src-tauri/src/main.rs did not compile. WebviewWindow::navigate takes a tauri::Url, but the offline path passed a WebviewUrl, so the app crate failed with E0277: the trait bound tauri::Url: From<WebviewUrl> is not satisfied (main.rs:103) against the locked Tauri 2.10.3. It now parses about:blank as a Url, which is what the code meant, and drops two unused imports (WebviewUrl, Emitter). Separate commit.

Checks

Run on 30 October 2026 with Rust 1.97.0:

  • cargo check --manifest-path src-tauri/Cargo.toml --locked: the lockfile resolved and crates downloaded, then it stopped after 20 seconds at gdk-sys with exit 101: "The system library gdk-3.0 required by crate gdk-sys was not found". This environment has no GTK 3 or WebKitGTK 4.1 development files.
  • The same command with stub pkg-config entries for the 11 missing GTK and WebKitGTK modules (in a scratch directory, not in the repo). cargo check does not link, so this type-checks the whole tree: every dependency checked, and the app crate failed with the E0277 above. After the fix: Finished dev profile, exit 0, one warning (app_handle is unused outside macOS, where its only use is compiled out). The macOS-only branch was not type-checked on this Linux host, and nothing was linked or run.
  • Android: not built here (no Android SDK). On GitHub Actions, the Build Android APK workflow's last two runs passed, on 20 January and 1 April 2026 (last run); its artifact has expired.
  • README check (check.mjs): no errors. Preview reviewed in light and dark.

Not fixed, for you to decide

  • The Android app is still labelled "WebView App" (app/src/main/res/values/strings.xml) and uses the template's green globe launcher icon.
  • The workflow signs every run with a fresh keystore whose password is android. That is fine for test builds, but successive APKs cannot update each other; a release would need a persistent keystore in repository secrets.
  • MyWebViewClient keeps a link in the app when its host endsWith("operatoruplift.com"), which also matches hosts such as notoperatoruplift.com. Comparing the exact host or the .operatoruplift.com suffix would be stricter.
  • The Java sources sit in com/example/app/ but declare package com.operatoruplift.app. They compile; moving them would be a rename, so I left them.
  • Licensing: the Android project comes from slymax's WebView template, which had no LICENSE file in this history, and the MIT LICENSE added on 1 April 2026 names only Operator Uplift.

Suggested repository settings

These live outside the code, so they are not in this PR:

  • Description: replace "a template project for android studio" with "Tauri 2 desktop shell and Android WebView shell for operatoruplift.com, from Operator Uplift's AI-assistant era. Superseded."
  • Topics: tauri, rust, android, webview, desktop-app
  • Social preview: upload docs/readme/banner.png (2400 × 1200) under Settings → General → Social preview.
  • Consider archiving the repository once this merges.

Generated by Claude Code

- WebviewWindow::navigate takes a tauri::Url, but main.rs passed a
  WebviewUrl, so the app crate failed with E0277 at main.rs:103 and the
  desktop shell could not build
- Parse about:blank as a Url instead, which is what the code meant
- Drop the WebviewUrl and Emitter imports that are now unused
- Checked with cargo check --locked, using stub pkg-config files for the
  GTK and WebKitGTK modules this environment lacks (type-check only)

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01TZhsuWjATuivuiFYJGpbY5
- Banner with the desktop shell's own offline page and a flow card for
  the desktop shell, the website and the Android shell
- Document the Android shell, its APK workflow and signing variables,
  which the old README never mentioned
- Drop retired claims about the website (38 pages, LLM chat, swarm
  orchestration, a memory engine) and mark both shells superseded
- Correct "shown after content loads": the window shows after a
  connection check and a 300 ms delay
- Add where the repo fit in the platform, and how to point the shells at
  another site

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01TZhsuWjATuivuiFYJGpbY5
@operatoruplift
operatoruplift merged commit 002a503 into master Oct 31, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants