relay-tty

This skill documents the Fumadocs documentation site at docs.relaytty.com. Use this skill when writing, updating, or organizing user-facing documentation, working with the screenshot pipeline, modifying docs config/theme, or when a feature change requires a corresponding docs update. Also use when the user mentions Diataxis, docs, llms.txt, or the docs site.

This skill documents the WebSocket binary protocol and buffer replay system used between the browser, server (WS bridge), and Rust pty-host. Use this skill when modifying WS message handling, buffer replay, reconnection logic, the RESUME/SYNC handshake, IndexedDB caching, or the OutputBuffer ring buffer in Rust. It prevents breaking the protocol contract between the three layers.

This skill should be used when modifying terminal input handling, adding new input fields or buttons to mobile UI, fixing keyboard or touch issues on Android/iOS, or working with xterm.js composition events. It documents hard-won patterns that prevent recurring mobile input bugs.

This skill should be used when modifying CSS layout, adding full-screen overlays, changing overflow properties, working with mobile keyboard viewport, adding `position: fixed` elements, or changing height units (vh, dvh, h-screen, h-app) in relay-tty. Prevents recurring layout bugs on mobile.

This skill should be used when adding or modifying mobile touch interactions, buttons, overlays, scrollable areas, or any UI that appears on top of the terminal. It documents the touch event architecture that prevents recurring bugs: focus steal, phantom keyboard, scroll hijacking, iOS drag snapback, and event leakage between layers.

This skill should be used when modifying touch scrolling, momentum physics, viewport sync, buffer replay, terminal pooling, or the ResizeObserver in use-terminal-core.ts. It documents monkey-patched xterm.js v5 internal APIs, scroll invariants, and the bugs each pattern prevents. Consult before any change to scrollState, setViewportActive, _innerRefresh, syncScrollArea, snapBottomUntilRef, replayingRef, or the ResizeObserver debounce logic.