Workbench
A plugin workbench with a file tree, code editor, terminal, and hot-reload preview.
Usage
Plugin development
Starts dev once on entering the viewport and adds a trigger to the manifest; then edit a file and press ⌘/Ctrl+S, and the terminal and preview hot-reload.
Loading demo...
Overview
A plugin workbench built around touch-translate, a translate-selection plugin: a file tree, editor tabs, a pnpm dev terminal, and a Problems panel, plus a CoreBox preview when wide. All terminal output is simulated and every duration is sample data.
- Plays once on first entering the viewport (under 6 seconds): the terminal starts
pnpm dev, then the trigger “dict” is typed into the first feature'scommandsin manifest.json and saved, and the preview goes from “No feature answers” to matching Translate selection. Any input from you stops the rest; a trigger being typed completes and saves at once, so the manifest is never left half-typed. With reduced motion the final state appears directly, without timers. - Only a save reaches the dev server: ⌘/Ctrl+S saves the current file, formatting JSON first; one second after you stop typing, every change saves itself (unformatted). manifest.json reloads the feature list, index.js restarts the Prelude, src and locales hot-update through Vite, and package.json only asks for a dev restart.
- When manifest.json is saved as JSON that does not parse, the dev server keeps the last good version: the status bar reads “manifest.json failed to parse · line N” and the preview is marked Stale. Problems follows the editor buffer live, also flags features without triggers and duplicate triggers, and clicking one jumps to its line and column.
- ⌘/Ctrl+J collapses or expands the terminal panel, and ⌘/Ctrl+Shift+F in the editor formats the current JSON file; editor tabs switch with ← / → and Home / End, close with Delete, and also close on a middle click.
- Below 640px the explorer moves into a drawer (closed by Esc or a click elsewhere) and there is no preview; 640–959px shows the file tree, editor, and terminal; at 960px and up the CoreBox preview joins on the right.
Customization
- To connect a real
tuff dev, replace the timed output inbootSteps()andreloadFile()with logs the dev server pushes (WebSocket / SSE), writing each line to TxTerminal; have the preview read the feature list the dev server actually loaded instead of parsing the manifest in the page. - TxCodeEditor's built-in format is
JSON.stringify(value, null, 2), which puts every array item on its own line, and it is bound to Mod-Shift-F. The template intercepts that shortcut in the capture phase and formats with short arrays kept inline; it writes back only the span that differs, so the caret does not jump to the end. - Do not use CodeMirror's
scrollIntoViewto reveal a line, since it scrolls the page too. The template takes the EditorView fromgetView()and usesrequestMeasureto scroll only the editor's own scroller. - TxCodeEditor and TxTerminal default to 160px-tall rounded cards; inside panels, override the minimum height, radius, and border. TxTerminal hands the host's computed background to xterm, so the background must be a plain color token, not
color-mix(). - The toolbar's text labels are visible text; the template hides them visually and keeps them as the icon buttons' accessible names. TxCodeEditor's dark theme is a fixed
#0d1117, so the neighboring tabs and terminal use--tx-fill-color-blankto stay close to it.
Related components
| Region | Components | Role |
|---|---|---|
| Title bar | TxIconButton, TxIconChip, TxTag, TxWorkingIndicator, TxStatusBadge | Panel toggles, project and branch, dev status |
| Explorer | TxTree | File tree with a dot on unsaved files |
| Editor | TxCodeEditor, TxCodeEditorToolbar, TxEmptyState | Tabbed editing, format, search, and copy |
| Panel | TxTerminal, TxIconButton | Simulated pnpm dev output and the Problems list |
| CoreBox preview (wide) | TxSearchInput, TxIconChip, TxTag, TxKbd, TxSearchEmpty, TxEmptyState, TxStatusHint | Matches features against the loaded manifest |
| Status bar | TxStatusHint, TxKbd | Last hot reload, problem counts, and shortcuts |
| Notifications | TxToastPanel | Results of saving, formatting, and copying |