This Tauri 2 application is the native host for the shared Rail frontend in
apps/v10/web. It does not maintain a second UI implementation.
pnpm devstarts the web app onhttp://127.0.0.1:3095through Tauri'sbeforeDevCommandand opens that URL in the native webview.pnpm buildcreates the web static export first, embedsapps/v10/web/out, and compiles the native release binary.pnpm check,pnpm lint,pnpm test, andpnpm format:checkrun the targeted Rust verification gates.pnpm verify:launchbuilds and starts the native binary, then verifies its launch, persisted window state, and platform-native controls. SeeLAUNCH_VERIFICATION.mdfor the automated macOS checks and the short visual signoff that still needs human eyes.
Move the window within 24 logical pixels of a monitor's left or right work-area
edge to snap it flush. The native Rail menu exposes the same actions through
CmdOrCtrl+Shift+ArrowLeft and CmdOrCtrl+Shift+ArrowRight while the app is
focused.
Use Keep on Top in the native Rail menu or tray, or press
CmdOrCtrl+Shift+P, to toggle the window's always-on-top state. Both checkboxes
stay synchronized with the real window state, which is saved immediately.
The desktop shell registers two system-global accelerators, so they work while
another app has focus: CmdOrCtrl+Shift+X emits the discretion panic() event
and hides the panel immediately, while CmdOrCtrl+Shift+L toggles panel
visibility. A hidden discretion session remains protected when shown and still
requires the Rail's explicit restore confirmation.
On macOS 14.4 and newer, a one-second native monitor uses ScreenCaptureKit's
current-process shareable-content API to observe whether the Rail window is
actively streamed. This path does not request Screen Recording permission or
inspect other applications. Linux and Windows return an explicit
supported: false status; detector errors do the same and never auto-restore
protected tiles.
All webview/native IPC names and payloads are closed by the shared
v10.shell-bridge.4 descriptor and Zod schemas in
libs/contracts/src/v10/shell-bridge.ts. Rust owns matching decoded types for
window operations, tray snapshots, native shortcut/menu events, and screen-share
status, and the dogfood journal; its contract audit reads the same JSON
descriptor so name or fixture drift fails the shell test suite.
The webview mirrors its versioned local dogfood journal through the typed
save_rail_dogfood_journal command. Rust independently decodes the closed calm
metric union, enforces event and byte bounds, rejects duplicate identifiers, and
replaces dogfood-journal.json through a private temporary file under the
platform app-data directory. The file and parent directory are owner-only on
Unix. Nothing uploads the journal; the native copy exists so the local
rail dogfood-report command can find it without a browser export.
Autostart is device-local and opt-in. The official Tauri autostart plugin is
registered with the macOS LaunchAgent backend, but setup never calls enable;
only the typed settings command can add or remove the operating-system login
registration, and every write is read back before success is reported.
The tray also exposes panel visibility, a discretion hide, live audio-lane play/pause, skip, and handoff controls, plus three disabled text glance lines. Its status includes the real holder volume and queued-offer count. Play/pause is capability-gated, handoff is enabled only for a queued offer, and an idle lane can accept that next offer without reopening the panel. Glances use the frontend's effective text-only projection during privacy modes. Closing the panel hides its live webview instead of destroying it, so the frontend kernel and tray transports continue running headless. Use Show Panel to restore the same session or Quit The Rail to exit it explicitly.
The shell writes window-state.json under the platform app-config directory on
focus loss, explicit docking, and close-to-tray. The versioned state restores
the monitor, dock edge, logical size, always-on-top value, and visibility on the
next launch.
Native packaging remains disabled at this scaffold stage. The release binary still uses Tauri's production custom protocol and embeds the static web bundle; installer targets can be enabled when the platform release work begins.
The packaged webview enforces an explicit CSP for the docked-player boundary: privacy-enhanced YouTube and the Twitch player are the only frame origins, the two official interactive-player SDK hosts are the only remote script origins, and the Rail itself rejects all frame ancestors. The exact provider-visible data, same-origin/SDK trust distinction, browser-host header requirements, and custom-protocol referrer release gate are documented in the web module's “Embed security and privacy review.”