diff --git a/apps/gpgui-helper/README.md b/apps/gpgui-helper/README.md
index 102e366..c12e8db 100644
--- a/apps/gpgui-helper/README.md
+++ b/apps/gpgui-helper/README.md
@@ -1,7 +1,36 @@
-# Tauri + React + Typescript
+# GP Connect download helper
-This template should help get you started developing with Tauri, React and Typescript in Vite.
+The desktop supervisor launches this window when the selected GUI is missing or
+has an incompatible version. It downloads the selected Tauri or Native Shell
+interface and requests installation through the service. Launches require the
+existing service credential and lifetime channel on stdin.
-## Recommended IDE Setup
+## Appearance
-- [VS Code](https://code.visualstudio.com/) + [Tauri](https://marketplace.visualstudio.com/items?itemName=tauri-apps.tauri-vscode) + [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer)
+`--theme system|light|dark` controls this window only. The default is `system`,
+which follows system appearance and changes while the window is open. Explicit
+`light` and `dark` modes override system appearance for that launch. Nothing is
+saved by the helper.
+
+Initial downloads follow the system. During Linux Tauri/Native Shell switches,
+Desktop Core supplies the running app's saved theme choice to the supervisor,
+which forwards it to the helper. There is no `--helper-theme` option on
+`gpclient launch-gui`.
+
+The native window and web content use the selected appearance before the window
+is shown. Browser previews follow the system when no native mode is supplied.
+
+## Development
+
+```sh
+pnpm build
+pnpm test
+```
+
+The built `dist/` assets are tracked and must be rebuilt after frontend changes.
+Run Rust checks and helper tests from the `gp` repository:
+
+```sh
+cargo check -p gpgui-helper
+cargo test -p gpgui-helper --lib
+```
diff --git a/apps/gpgui-helper/dist/assets/main-DZdDLhQH.js b/apps/gpgui-helper/dist/assets/main-BJvLW_Ih.js
similarity index 100%
rename from apps/gpgui-helper/dist/assets/main-DZdDLhQH.js
rename to apps/gpgui-helper/dist/assets/main-BJvLW_Ih.js
diff --git a/apps/gpgui-helper/dist/assets/main-CVTp2z3I.css b/apps/gpgui-helper/dist/assets/main-CVTp2z3I.css
new file mode 100644
index 0000000..4fd3aca
--- /dev/null
+++ b/apps/gpgui-helper/dist/assets/main-CVTp2z3I.css
@@ -0,0 +1 @@
+:root{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light;--background:#f6f5f4;--foreground:#2e3436;--muted-foreground:#5e5c64;--progress-label:#3d3846;--progress-track:#d5d3d1;--progress-fill:#3584e4;--error:#9c2f2f;--button:#1c71d8;--button-hover:#1a5fb4;--button-active:#174a8b;--focus-ring:#1a5fb4}:root[data-theme=dark]{--lightningcss-light: ;--lightningcss-dark:initial;color-scheme:dark;--background:#242424;--foreground:#fff;--muted-foreground:#c0bfbc;--progress-label:#deddda;--progress-track:#454545;--progress-fill:#78aeed;--error:#ffb4ab;--button:#1c71d8;--button-hover:#3584e4;--button-active:#1a5fb4;--focus-ring:#78aeed}html,body,#root{box-sizing:border-box;-webkit-user-select:none;user-select:none;cursor:default;height:100%;margin:0;padding:0;overflow:hidden}body{background:var(--background);color:var(--foreground);font-family:Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif}button{font:inherit}.update-window{box-sizing:border-box;background:var(--background);align-items:center;gap:15px;width:100%;height:100%;padding:16px 18px;display:flex}.update-logo{flex:none;width:48px;height:48px}.update-content,.update-status{width:100%;min-width:0}.update-title{color:var(--foreground);letter-spacing:-.01em;margin:0;font-size:16px;font-weight:600;line-height:1.25}.update-description{color:var(--muted-foreground);margin:3px 0 0;font-size:12px;line-height:1.4}.progress-summary{justify-content:space-between;align-items:baseline;gap:12px;margin-top:3px;display:flex}.progress-summary .update-description{margin:0}.progress-bar{background-color:var(--progress-track);border-radius:3px;width:100%;height:6px;margin-top:9px;position:relative;overflow:hidden}.progress-fill{background:var(--progress-fill);border-radius:3px;height:100%;transition:width .18s ease-out}.progress-bar-indeterminate .progress-fill{width:35%;animation:1.4s ease-in-out infinite progress-indeterminate}@keyframes progress-indeterminate{0%{transform:translate(-110%)}to{transform:translate(300%)}}@media (prefers-reduced-motion:reduce){.progress-fill{transition:none}.progress-bar-indeterminate .progress-fill{animation:none;transform:translate(90%)}}.progress-label{color:var(--progress-label);font-variant-numeric:tabular-nums;text-align:right;white-space:nowrap;flex:none;font-size:12px;font-weight:500}.error-status{justify-content:space-between;align-items:center;gap:16px;display:flex}.error-status .update-title{color:var(--error)}.error-copy{min-width:0}.retry-button{background:var(--button);color:#fff;cursor:default;border:0;border-radius:8px;min-width:68px;padding:4px 14px;font-size:12px;font-weight:600;line-height:1.5}.retry-button:hover{background:var(--button-hover)}.retry-button:active{background:var(--button-active)}.retry-button:focus-visible{outline:2px solid var(--focus-ring);outline-offset:2px}
diff --git a/apps/gpgui-helper/dist/assets/main-DiWGniCh.css b/apps/gpgui-helper/dist/assets/main-DiWGniCh.css
deleted file mode 100644
index 718afda..0000000
--- a/apps/gpgui-helper/dist/assets/main-DiWGniCh.css
+++ /dev/null
@@ -1 +0,0 @@
-html,body,#root{box-sizing:border-box;-webkit-user-select:none;user-select:none;cursor:default;height:100%;margin:0;padding:0;overflow:hidden}body{color:#2e3436;background:#f6f5f4;font-family:Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif}button{font:inherit}.update-window{box-sizing:border-box;background:#f6f5f4;align-items:center;gap:15px;width:100%;height:100%;padding:16px 18px;display:flex}.update-logo{flex:none;width:48px;height:48px}.update-content,.update-status{width:100%;min-width:0}.update-title{color:#2e3436;letter-spacing:-.01em;margin:0;font-size:16px;font-weight:600;line-height:1.25}.update-description{color:#5e5c64;margin:3px 0 0;font-size:12px;line-height:1.4}.progress-summary{justify-content:space-between;align-items:baseline;gap:12px;margin-top:3px;display:flex}.progress-summary .update-description{margin:0}.progress-bar{background-color:#d5d3d1;border-radius:3px;width:100%;height:6px;margin-top:9px;position:relative;overflow:hidden}.progress-fill{background:#3584e4;border-radius:3px;height:100%;transition:width .18s ease-out}.progress-bar-indeterminate .progress-fill{width:35%;animation:1.4s ease-in-out infinite progress-indeterminate}@keyframes progress-indeterminate{0%{transform:translate(-110%)}to{transform:translate(300%)}}@media (prefers-reduced-motion:reduce){.progress-fill{transition:none}.progress-bar-indeterminate .progress-fill{animation:none;transform:translate(90%)}}.progress-label{color:#3d3846;font-variant-numeric:tabular-nums;text-align:right;white-space:nowrap;flex:none;font-size:12px;font-weight:500}.error-status{justify-content:space-between;align-items:center;gap:16px;display:flex}.error-status .update-title{color:#9c2f2f}.error-copy{min-width:0}.retry-button{color:#fff;cursor:pointer;background:#1c71d8;border:0;border-radius:8px;min-width:68px;padding:4px 14px;font-size:12px;font-weight:600;line-height:1.5}.retry-button:hover{background:#1a5fb4}.retry-button:active{background:#174a8b}.retry-button:focus-visible{outline-offset:2px;outline:2px solid #1a5fb4}
diff --git a/apps/gpgui-helper/dist/index.html b/apps/gpgui-helper/dist/index.html
index f799e86..e8fe51e 100644
--- a/apps/gpgui-helper/dist/index.html
+++ b/apps/gpgui-helper/dist/index.html
@@ -2,11 +2,21 @@