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 { expandOwnerStorePath } from "@/lib/owner-store-path.js";
import { promises as fs } from "fs";
import os from "os";
import path from "path";
import type { Tweaks } from "@/lib/appearance";
import type { Quicklink } from "@/lib/quicklinks";
import type { PrefUpdates } from "./updates";
// Cross-device prefs (appearance tweaks + quicklinks + update automation),
// mirroring lib/config/store: a host JSON file (chmod 600) read/written
// server-side only, atomic tmp+rename. `wallpaperStyle` is computed client-side
// from `wallpaperImage` (parseImage → withWallpaperStyle), so it is never
// persisted — the route strips it.
/** Persisted tweaks: everything except the computed CSS style object. */
export type PrefTweaks = Omit<Tweaks, "wallpaperStyle">;
export interface OsPrefs {
tweaks?: PrefTweaks;
quicklinks?: Quicklink[];
/** Owner-only automation settings. Runtime outcomes are NOT stored here — the
* updater writes ~/.mso/auto-update-state.json so a client can never forge a
* "last result", and the two writers never lose each other's section. */
updates?: PrefUpdates;
updatedAt?: number;
}
// Resolved lazily (not module-level) so tests can point OS_PREFS_PATH at a tmp dir.
function prefsPath(): string {
return expandOwnerStorePath(process.env.OS_PREFS_PATH ?? path.join(os.homedir(), ".mso", "prefs.json"));
}
export async function readPrefs(): Promise<OsPrefs> {
try {
return JSON.parse(await fs.readFile(prefsPath(), "utf8")) as OsPrefs;
} catch {
return {};
}
}
// Serializes the read-modify-write below so two concurrent section POSTs
// (tweaks + quicklinks) can't both read the same `current` and clobber each
// other's section. Each call chains onto the previous one's settle.
let writeChain: Promise<unknown> = Promise.resolve();
async function writePrefsUnlocked(patch: Partial<OsPrefs>): Promise<OsPrefs> {
const file = prefsPath();
const current = await readPrefs();
const next: OsPrefs = { ...current, ...patch, updatedAt: Date.now() };
await fs.mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
const tmp = `${file}.tmp`;
await fs.writeFile(tmp, JSON.stringify(next, null, 2), { encoding: "utf8", mode: 0o600 });
await fs.rename(tmp, file);
return next;
}
/** Section-level merge (last write wins per section) + updatedAt stamp.
* Writes are serialized through a queue to avoid a read-modify-write race. */
export async function writePrefs(patch: Partial<OsPrefs>): Promise<OsPrefs> {
const run = writeChain.then(() => writePrefsUnlocked(patch));
// Keep the chain alive even if a write rejects (don't poison later writes).
writeChain = run.catch(() => undefined);
return run;
}