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 type { AppDescriptor } from "./types";
/** null defers a rewrite while a restored app is absent from the async registry. */
export function stateToUrl(apps: AppDescriptor[], appId: string | null, payload: unknown): string | null {
if (!appId) return "/";
const app = apps.find((entry) => entry.id === appId);
if (!app) return null;
const path = (payload as { path?: unknown } | null)?.path;
const suffix = typeof path === "string" && path ? "/" + path.replace(/^\/+/, "") : "";
return "/" + (app.slug ?? app.id) + suffix;
}