Repository navigation
docs: add Rust + Rune port roadmap - #37
Draft
billyjacoby wants to merge 5 commits into
Draft
billyjacoby wants to merge 5 commits into
billyjacoby wants to merge 5 commits into
Conversation
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
force-pushed
the
docs/rust-gpui-port-roadmap
branch
from
November 8, 2026 14:06
19731d6 to
d8c529f
Compare
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 andrune-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/httpslinks reachApp::on_open_url, both while the app is running and when a link launches itInfo.plistkeys (Rune'sscripts/mac-appwrites only one custom scheme)tray-iconworking inside Rune's event loopResults go in
docs/SPIKE_NOTES.md, and later phases refer back to them.Target layout: a Cargo workspace with three crates:
core: pure, testable logicmacos: platform calls such as default browser, icons, cursor positionapp: the Rune binaryOrder: 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:
Every Rune API name in the doc was checked against
devata7f276c(2026-11-08).Bugs found in the current TypeScript app (used in the doc as exercises; not fixed in this PR):
AppButton.tsxpasses Alt and Shift toonBrowserButtonClickin swapped order.getInstalledAppsthrows 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