Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
import { pruneFeatureState } from "./feature-state";
import type { ShellState, WindowState, WinId } from "./types";
// Module-level external store, held in a mutable `M` object (not a rebindable
// `let`) so the action functions in store.ts can mutate ONE shared instance
// across files. The hot path (drag/resize) replaces ONE window object and
// notifies; React bails out on every window whose snapshot ref is unchanged
// (Object.is), so only the moved window re-renders — 60fps with 24 panes.
type Listener = () => void;
export const M = {
state: {
windows: {},
order: [],
focused: null,
activeSpace: 1,
launcherOpen: false,
spotlightOpen: false,
inspectorOpen: false,
notificationCenterOpen: false,
} as ShellState,
seq: 0,
};
const listeners = new Set<Listener>();
let previousOrder = M.state.order;
export function emit() {
if (previousOrder !== M.state.order) {
previousOrder = M.state.order;
pruneFeatureState(new Set(previousOrder));
}
listeners.forEach((l) => l());
}
export const shellStore = {
subscribe(l: Listener) {
listeners.add(l);
return () => listeners.delete(l);
},
getWindow(id: WinId): WindowState | undefined {
return M.state.windows[id];
},
// The whole windows map — a stable ref that changes (via patch) whenever any
// window does, so a component reading several windows re-renders on any change
// instead of tearing (reading getWindow during render under an order-only sub).
getWindows(): Record<WinId, WindowState> {
return M.state.windows;
},
getOrder(): WinId[] {
return M.state.order;
},
getFocused(): WinId | null {
return M.state.focused;
},
getLauncherOpen(): boolean {
return M.state.launcherOpen;
},
getSpotlightOpen(): boolean {
return M.state.spotlightOpen;
},
getInspectorOpen(): boolean {
return M.state.inspectorOpen;
},
getNotificationCenterOpen(): boolean {
return M.state.notificationCenterOpen;
},
getActiveSpace(): number {
return M.state.activeSpace;
},
};
export function topZ(): number {
return M.state.order.reduce((m, id) => Math.max(m, M.state.windows[id]?.z ?? 0), 0);
}
/** A copy of `ids` sorted ascending by window z (focus recency) — paint order
* for the window layer so the visible stack matches the store's MRU. Takes the
* windows map so callers can `useMemo` on the reactive snapshot (not raw z). */
export function stackByZ(ids: WinId[], windows: Record<WinId, WindowState>): WinId[] {
return [...ids].sort((a, b) => (windows[a]?.z ?? 0) - (windows[b]?.z ?? 0));
}
export function patch(id: WinId, p: Partial<WindowState>) {
const win = M.state.windows[id];
if (!win) return;
M.state = { ...M.state, windows: { ...M.state.windows, [id]: { ...win, ...p } } };
emit();
}