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 { Metadata, Viewport } from "next";
import { headers } from "next/headers";
import { GeistSans } from "geist/font/sans";
import { GeistMono } from "./mono-font";
import { RegisterSW } from "./register-sw";
import "./globals.css";
import { BootSplash } from "./boot-splash";
import { publicMsoOrigin } from "@/lib/mcp/ui-config";
export function generateMetadata(): Metadata {
return {
metadataBase: new URL(publicMsoOrigin()),
applicationName: "Manef Shell OS",
title: "Manef Shell OS — browser-based server control plane",
description:
"A browser-based graphical shell for a Linux server you own — terminal, files, metrics, and AI in one mobile-first pane.",
manifest: "/manifest.webmanifest",
appleWebApp: {
capable: true,
title: "MSO",
statusBarStyle: "black-translucent",
},
// Favicon + apple-touch + OG come from the file conventions (app/icon.svg,
// app/apple-icon.tsx, app/opengraph-image.tsx) — no manual `icons` field.
openGraph: {
title: "Manef Shell OS — browser-based server control plane",
description:
"A browser-based graphical shell for a Linux server you own — terminal, files, metrics, and AI in one mobile-first pane.",
siteName: "Manef Shell OS",
type: "website",
},
twitter: {
card: "summary_large_image",
title: "Manef Shell OS — browser-based server control plane",
description:
"A browser-based graphical shell for a Linux server you own — terminal, files, metrics, and AI in one mobile-first pane.",
},
// Owner-only tool behind client auth — keep it out of search indexes (every
// catch-all slug returns 200 HTML). The GitHub repo is the discoverable surface.
robots: { index: false, follow: false },
};
}
export const viewport: Viewport = {
width: "device-width",
initialScale: 1,
// Draw under the notch / home-bar so the shell's safe-area-inset padding
// (--sai-*) actually has insets to work with in standalone mode.
viewportFit: "cover",
themeColor: "#0a0a0a",
};
export default async function RootLayout({
children,
}: {
children: React.ReactNode;
}) {
// Per-request nonce (set by proxy.ts) so the pre-hydration theme script passes
// the strict CSP script-src.
const nonce = (await headers()).get("x-nonce") ?? undefined;
// Geist variable classes MUST live on <html>: --font-ui/--font-mono-ui are
// defined on :root and reference var(--font-geist-*) — defined only on
// <body>, the :root custom property is invalid at computed-value time and
// silently collapses to the Tailwind preflight stack (fonts never apply).
return (
<html
lang="en"
data-theme="light"
suppressHydrationWarning
className={`${GeistSans.variable} ${GeistMono.variable}`}
>
<body className="antialiased overflow-hidden select-none">
{/* Pre-hydration theme: set data-theme from localStorage before the body
paints (dark users otherwise get a light flash). A raw nonced <script>
at body-top runs synchronously during parse; the nonce (proxy.ts →
x-nonce header) satisfies the strict CSP script-src. */}
{/* suppressHydrationWarning is REQUIRED here, not cosmetic. Browsers blank the
`nonce` content attribute once CSP has consumed it — a deliberate
anti-exfiltration measure — so the DOM reports nonce="" while the server
HTML carried the real value. React compares the attribute and reports a
mismatch on EVERY page load. Confirmed against a non-minified dev build:
+ nonce="NjA3NDAxNWIt…" (server)
- nonce="" (client)
The nonce itself must stay: proxy.ts mints it per request and the strict
CSP script-src will not execute this script without it. */}
<script
nonce={nonce}
suppressHydrationWarning
dangerouslySetInnerHTML={{
__html:
'try{var t=JSON.parse(localStorage.getItem("mso:tweaks"));if(t&&t.theme)document.documentElement.dataset.theme=t.theme;if(t&&t.theme==="dark")document.documentElement.style.setProperty("--mso-boot-background","linear-gradient(145deg,#161629 0%,#10152c 58%,#0b1223 100%)");}catch(e){}',
}}
/>
<BootSplash />
{children}
<RegisterSW />
</body>
</html>
);
}