Repository navigation
UI Shell
nodemode-ai edited this page Nov 8, 2026
·
1 revision
The shell is mounted once from a string template and then patched in place: nothing already rendered is rebuilt. It holds the titlebar (menus, tabs, zoom), the options bar, the tool rail, the stage, the layers panel and the status bar, plus dialogs and toasts in their own roots.
| Source path | What lives there |
|---|---|
frontend/src/app.ts |
Mounting, commands, menus, keyboard, paste, drag and drop, file I/O flows, the reveal gate |
frontend/src/ui/stage.ts |
Scene and overlay canvases, pointer input, pixel view at 200 percent and up, marching ants, the sample ring |
frontend/src/ui/layers.ts |
Keyed layer rows, thumbnails, visibility swipe, drag reorder (Option duplicates), Option-click clipping on a row's lower edge, Option-drag mask copy, drag onto another project's tab to copy the layer there, rename, context menu |
frontend/src/ui/rail.ts, options.ts, tabs.ts, status.ts
|
Tool rail and colors (the swatches open the color picker), options bar with editable number fields, project tabs, status bar |
frontend/src/ui/menu.ts, dialogs.ts, app-dialogs.ts, toast.ts, commands.ts
|
Menus (File's Open Recent section is computed each time the menu opens), dialogs (a click-through scrim lets eyedroppers reach the canvas), toasts, the command registry and key labels |
frontend/src/ui/brand.ts |
The app mark, inline on the welcome card and in About (the same artwork as the desktop icon and favicon), with its ids namespaced per copy |
frontend/src/ui/panels/ |
Adjustment panel in layer and image modes (Levels Auto and black, gray and white eyedroppers; Hue/Saturation spectrum band handles, Sample, Add and Remove eyedroppers and targeted adjustment), filter panel, Remove Background panel (Basic and Advanced refine), JPEG export sheet, color picker, Canvas Size, Image Size, the amount dialog, and their control rows |
frontend/src/engine/doc-views.ts, frontend/src/ui/view-tiles.ts, float-views.ts, view-canvas.ts
|
Window > Arrange. doc-views.ts holds the extra views that share a project (New Window for Document, floating or tiled); view-tiles.ts lays them out (tabs, 2up-v, 2up-h, 3up, 4up, 6up, the layout kept under formvis.arrange) with draggable gutters no smaller than 120 pixels; float-views.ts draws the floating frames (Float in Window, Float All in Windows; Consolidate All to Tabs closes them); view-canvas.ts draws and binds one view. A view or frame pans, zooms and rotates but takes no tool input, and views and tile sizes are not saved with the project |
frontend/src/ui/clone-source-panel.ts, ui/panels/toolbar-dialog.ts, ui/panels/script-console-dialog.ts
|
The Clone Source panel (docked, hidden by default), Edit > Toolbar (the rail's groups, saved as the toolbar preference) and Window > Script Console |
frontend/src/ui/i18n.ts, ui/i18n/
|
The interface languages and the page translator: see Languages |
frontend/src/ui/dom.ts |
NodeMode dom-stable helpers plus small in-place setters |
frontend/src/ui/icons.ts, themes.ts
|
The 80 icons copied verbatim from NodeMode, the 14 theme profiles |
frontend/src/styles/ |
NodeMode tokens and the component sheets; scrollbars.css loads last |
- Render a container once, then patch:
patchListfor keyed lists,setText,setClass,setHiddenand the other setters for single values. Never clear and refill. - Reserve space before content arrives; a node appearing or a label changing must not move its neighbors.
- Colors and z-index come from tokens only. New stacking needs a
--z-*token intokens.css. - Icons come from
ui/icons.ts; no icon libraries. - Every UI change passes the procedure on Verification.