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
"use client";
import { useSyncExternalStore } from "react";
import { registerCommands } from "./commands";
// Lock screen — overlay state + an optional consumer-injected unlock guard
// (auth check). No guard → click/key unlocks (kiosk-style privacy curtain).
// Idle auto-lock minutes persist to sv:autolock. The TIMER is not here: it is
// useIdleAutoLock (./use-idle-auto-lock), mounted from the shell provider so it
// stays eager even though the curtain's chunk is deferred.
let locked = false;
let guard: (() => boolean | Promise<boolean>) | null = null;
const subs = new Set<() => void>();
function emit() {
subs.forEach((f) => f());
}
export function lock(): void {
if (!locked) {
locked = true;
emit();
}
}
/** Runs the consumer guard (if any); unlocks when it passes. */
export async function requestUnlock(): Promise<boolean> {
if (!locked) return true;
const ok = guard ? await guard() : true;
if (ok) {
locked = false;
emit();
}
return ok;
}
/** Consumer auth hook — return false to keep the screen locked. */
export function setUnlockGuard(fn: (() => boolean | Promise<boolean>) | null): void {
guard = fn;
}
export function useLocked(): boolean {
return useSyncExternalStore(
(cb) => {
subs.add(cb);
return () => {
subs.delete(cb);
};
},
() => locked,
() => locked,
);
}
// ── idle auto-lock preference (minutes; null = off) ─────────────────────────
const KEY = "sv:autolock";
export function autoLockMinutes(): number | null {
if (typeof localStorage === "undefined") return null;
const v = Number(localStorage.getItem(KEY));
return Number.isFinite(v) && v > 0 ? v : null;
}
/** Set the idle auto-lock timeout in minutes; null/≤0 turns it off. */
export function setAutoLockMinutes(min: number | null): void {
if (typeof localStorage === "undefined") return;
try {
if (min && min > 0) localStorage.setItem(KEY, String(min));
else localStorage.removeItem(KEY);
} catch {
/* quota */
}
}
registerCommands("lock", [
{
id: "lock:now",
label: "Lock screen",
hint: "System",
keywords: "privacy curtain idle away",
run: lock,
},
]);