Skip to content

docs: add Rust + Rune port roadmap - #37

Draft
billyjacoby wants to merge 5 commits into
mainfrom
docs/rust-gpui-port-roadmap
Draft

billyjacoby wants to merge 5 commits into
mainfrom
docs/rust-gpui-port-roadmap

Conversation

@billyjacoby

@billyjacoby billyjacoby commented Oct 14, 2026 •

Copy link
Copy Markdown
Owner

Summary

Adds docs/RUST_PORT_ROADMAP.md, a step-by-step plan for porting Browsernaut from Tauri v1 + React/TypeScript to a Rust app built on Rune and rune-kit. It's written as a learning path: the reader writes the code, and the doc guides them.

  • Structure: 12 phases (0, 0.5, 1–10). Each lists the Rust concepts it covers, the existing files it replaces, hints rather than solutions, and a "done when" check.

  • Phase 0.5 is a spike that tests the risky assumptions on a real Mac before anything is built on them:

    • http/https links reach App::on_open_url, both while the app is running and when a link launches it
    • a bundling path that writes all the browser Info.plist keys (Rune's scripts/mac-app writes only one custom scheme)
    • tray-icon working inside Rune's event loop
    • placing the picker window at the cursor in physical pixels
    • which CI runners can run headless tests

    Results go in docs/SPIKE_NOTES.md, and later phases refer back to them.

  • Target layout: a Cargo workspace with three crates:

    • core: pure, testable logic
    • macos: platform calls such as default browser, icons, cursor position
    • app: the Rune binary
  • Order: pure Rust first (app list, app discovery, settings), then macOS integration, then the Rune picker and preferences windows, then receiving URLs and the tray icon, then themes, then shipping. The last phase deletes the Tauri/TypeScript code.

  • Rune-specific parts:

    • its one-state-struct-per-window model, compared with React/Zustand
    • headless UI tests from Phase 5 on
    • accessory apps and always-on-top windows for the picker
    • custom themes simplified to three palette seeds

    Every Rune API name in the doc was checked against dev at a7f276c (2026-11-08).

  • Bugs found in the current TypeScript app (used in the doc as exercises; not fixed in this PR):

    • AppButton.tsx passes Alt and Shift to onBrowserButtonClick in swapped order.
    • getInstalledApps throws away a .filter() result, so uninstalled apps are never removed from the list.

Documentation only; no code changes. Rebased on main (v1.3.6).

🤖 Generated with Claude Code

https://claude.ai/code/session_01MgLRbJSHKV9vRZYBTMRg8C

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MgLRbJSHKV9vRZYBTMRg8C
Rewrite the UI phases (5-9) for Rune's view/state model, headless
runtime tests, App lifetime hooks, on_open_url, and rune-kit components.
Update the app count after the registry sync on main.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MgLRbJSHKV9vRZYBTMRg8C
@billyjacoby
billyjacoby force-pushed the docs/rust-gpui-port-roadmap branch from 19731d6 to d8c529f Compare November 8, 2026 14:06
@billyjacoby billyjacoby changed the title docs: add Rust + GPUI port roadmap docs: add Rust + Rune port roadmap Nov 8, 2026
claude and others added 3 commits November 8, 2026 14:13
Add Phase 0.5, which checks on a real Mac that http/https links reach
on_open_url, picks a bundling path (mac-app only writes one custom
scheme), and tests tray-icon, window placement and headless CI before
any of it is built on. Point Phases 5-7 and 10 at the spike results,
and note the Rune rev the API names were checked against.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MgLRbJSHKV9vRZYBTMRg8C
Add the Phase 0 setup: mise tool pins, a Cargo workspace with core,
macos and app crates, and a pinned Rune git dependency. Add
docs/RUST_PORT_PROGRESS.md to track position and handoff notes, and
update the roadmap for mise, the Rune pin, and CI moving to Phase 1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Add a project skill for updating the port's progress file and roadmap
under the freeze rule. Rename the commented-out workflow so GitHub stops
reporting it as a failed run, and record the pnpm pin problem.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants