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 { expect } from "@playwright/test";
// Intercept only the synthetic fixture's browser service. Never start the host browser.
export async function camoufoxConnectionJourney(page, fixture) {
let mode = "tls", reads = 0, posts = 0, credentials = 0;
const observe = request => { if (new URL(request.url()).pathname === "/api/v1/camoufox/session") credentials++; };
const service = async route => {
const request = route.request(), url = new URL(request.url());
if (request.method() !== "GET") {
posts++;
return route.fulfill({ status: 503, json: { error: "Power mutation is forbidden in connection-only retry" } });
}
if (url.searchParams.get("probe") === "viewer") return route.fulfill({
status: 200, json: mode === "private"
? { reachable: false, state: "client-only", clientOnly: true, message: "Client must verify the private deployment viewer" }
: { reachable: false, state: "tls", message: "Fixture viewer TLS failed" },
});
reads++;
const running = mode !== "stopping" || reads === 1;
return route.fulfill({ status: 200, json: { installed: true, running, enabled: false, viewerReady: mode !== "stopping" } });
};
const viewerOrigin = "https://camoufox-fixture.invalid";
const session = route => route.fulfill({
status: 200,
json: {
password: null,
viewerOrigin,
viewerTicket: "fixture-viewer-ticket-0123456789abcdef",
viewerPathPrefix: "/_mso-camoufox",
},
});
const viewer = route => route.fulfill({ status: 200, contentType: "text/html", body: "<!doctype html><title>Private fixture viewer</title><p>Client-only viewer fixture</p>" });
page.on("request", observe);
await page.route("**/api/v1/camoufox/session", session);
await page.route("**/vnc.html?*", viewer);
await page.route("**/api/v1/camoufox/service*", service);
try {
for (const viewport of [{ width: 1280, height: 900 }, { width: 390, height: 844 }]) {
mode = "tls"; reads = 0; const beforeCredentials = credentials;
await page.setViewportSize(viewport);
await page.goto(fixture.base + "/browser");
const retry = page.getByRole("button", { name: "Retry connection", exact: true });
const connectionAlert = page.getByRole("alert").filter({ has: retry });
await expect(connectionAlert).toContainText("Fixture viewer TLS failed");
await expect(page.getByText("Running on the server", { exact: true })).toBeVisible();
for (let i = 0; i < 3; i++) {
await retry.click();
await expect(retry).toBeEnabled();
await expect(connectionAlert).toContainText("Fixture viewer TLS failed");
}
expect(posts).toBe(0); expect(credentials).toBe(beforeCredentials);
mode = "private"; reads = 0;
await retry.click();
const frame = page.locator('iframe[title="Camoufox browser"]');
await expect(frame).toBeVisible();
expect((await frame.getAttribute("src")) ?? "").toContain(viewerOrigin + "/_mso-camoufox/vnc.html?");
await expect(page.frameLocator('iframe[title="Camoufox browser"]').getByText("Client-only viewer fixture")).toBeVisible();
expect(credentials).toBe(beforeCredentials + 1); expect(posts).toBe(0);
mode = "stopping"; reads = 0;
await page.goto(fixture.base + "/browser");
await expect(page.getByText("The browser session is off.", { exact: true })).toBeVisible();
await expect(page.getByRole("button", { name: "Turn the browser on", exact: true })).toBeVisible();
await expect(page.getByText("Running on the server", { exact: true })).toHaveCount(0);
expect(posts).toBe(0); expect(reads).toBe(2);
}
console.log("PASS Camoufox read-only retries, client-only private viewer mounting, no premature credentials, and observed stop on desktop/mobile");
} finally {
page.off("request", observe);
await page.unroute("**/api/v1/camoufox/session", session);
await page.unroute("**/vnc.html?*", viewer);
await page.unroute("**/api/v1/camoufox/service*", service);
}
}