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
// Types for perf-report.mjs. Kept in a .d.ts so the implementation stays under the
// repo's 220-line ratchet and the shapes are visible to the TypeScript side (allowJs).
//
// `tbtMs` is nullable on purpose: null means "the probe did not observe one", which the
// gate treats as a violation when a baseline exists. It must never be coerced to 0.
export type PerfRun = {
label: string;
viewport?: { width: number; height: number };
fcpMs: number | null;
lcpMs: number | null;
tbtMs: number | null;
cls: number | null;
longTasks?: number;
maxLongTaskMs: number | null;
firstLoadJsBytes: number | null;
firstLoadJsFiles?: number;
transferBytes?: number;
domNodes?: number;
};
export type PerfReport = {
schemaVersion: number;
createdAt?: string;
commit?: string | null;
host?: { platform: string; cpus: number; node: string; totalMemMb: number };
profile?: { name: string; latencyMs: number; downlinkKbps: number; uplinkKbps: number; cpuRate: number };
runs: PerfRun[];
};
export type PerfSummary = {
label: string;
fcpMs: number | null;
lcpMs: number | null;
tbtMs: number | null;
cls: number | null;
firstLoadJsBytes: number | null;
maxLongTaskMs: number | null;
};
export type PerfBudget = {
schemaVersion?: number;
note?: string;
enforce: { firstLoadJsBytes?: Record<string, number>; tbtMsBlowupFactor?: number };
targets?: { initialGzipBytes?: number; tbtMs?: number; lcpMs?: number };
targetsEnforced?: boolean;
};
export function parsePerfReport(json: unknown): PerfReport;
export function summarize(report: PerfReport | { runs?: Array<Record<string, unknown>> } | string): PerfSummary[];
export function perfViolations(
report: PerfReport | { runs?: Array<Record<string, unknown>>; host?: { loadAvg1?: number } } | string,
budget: PerfBudget | null | undefined,
baseline?: PerfReport | { runs?: Array<Record<string, unknown>> } | Record<string, unknown> | null,
): string[];
export function formatTable(report: PerfReport | { runs?: Array<Record<string, unknown>> } | string): string;
export function timingSkipReason(
report: PerfReport | { runs?: Array<Record<string, unknown>>; host?: { loadAvg1?: number } } | string,
budget: PerfBudget | null | undefined,
): string | null;