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 { memo } from "react";
import { Sparkles, User } from "lucide-react";
import { cn } from "@/lib/utils";
import { mdToHtml } from "../features/widgets/components/md";
import { CopyButton } from "./copy-button";
export type ChatRole = "user" | "assistant" | "tool";
export type ToolStatus = "pending" | "running" | "ok" | "error" | "denied";
// A host tool call surfaced in the transcript (rendered by ApprovalCard, not
// MessageBubble). `danger` is the advisory destructive-pattern reason (exec.run).
export type ToolCard = {
name: string;
effect: "read" | "mutate";
input: Record<string, unknown>;
status: ToolStatus;
result?: string;
danger?: string;
approvalScope?: string;
};
export type ChatMessage = {
id: string;
createdAt?: number;
role: ChatRole;
text?: string;
/** Present only on `role: "tool"` rows. */
tool?: ToolCard;
};
// One chat row: user messages align right (primary bubble), assistant messages
// align left with a Sparkles avatar. Tool rows are routed to ApprovalCard by the
// chat panel, so this only renders user/assistant. All colour via theme tokens.
function legacyMessageTime(id: string): number | undefined {
const match = /^m(\d+)-/.exec(id);
return match ? Number(match[1]) : undefined;
}
// memoised: the transcript re-renders on every streamed token, but only the last
// assistant bubble actually changes — without this every prior row re-parsed its
// markdown and recomputed its timestamp per token. Props are the message object
// (stable unless that row was patched) + ios, so the default shallow compare holds.
export const MessageBubble = memo(function MessageBubble({ message, ios }: { message: ChatMessage; ios?: boolean }) {
const createdAt = message.createdAt || legacyMessageTime(message.id);
const time = createdAt ? new Date(createdAt).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit", second: "2-digit", hour12: false }) : null;
const isUser = message.role === "user";
return (
<div className="contents">
<div
className={cn(
"flex w-full min-w-0 items-start gap-2.5",
isUser ? "flex-row-reverse" : "flex-row",
)}
>
{/* iMessage shows no per-bubble avatar in the thread — keep it off on iOS. */}
{!ios && (
<span
className={cn(
"mt-0.5 grid size-7 flex-none place-items-center rounded-full",
isUser
? "bg-secondary text-secondary-foreground"
: "bg-primary text-primary-foreground",
)}
>
{isUser ? <User className="size-3.5" /> : <Sparkles className="size-3.5" />}
</span>
)}
<div className={cn("min-w-0", ios ? "max-w-[74%]" : "max-w-[82%]")}>
<div
className={cn(
"select-text [user-select:text] [-webkit-user-select:text] [-webkit-touch-callout:default] min-w-0 whitespace-pre-wrap break-words [overflow-wrap:anywhere]",
// iOS = iMessage silhouette: 19px bubble with the tail at the BOTTOM
// corner (points down at the sender); received bubble = systemFill gray.
ios
? cn(
"rounded-[19px] px-[13px] py-2 text-[15px] leading-[1.35]",
isUser ? "rounded-br-[6px] bg-primary text-primary-foreground" : "rounded-bl-[6px] bg-[var(--fill2)] text-foreground",
)
: cn(
"rounded-2xl px-3.5 py-2 text-sm leading-relaxed",
isUser ? "rounded-tr-sm bg-primary text-primary-foreground" : "rounded-tl-sm bg-muted text-foreground",
),
)}
>
{!message.text ? (
<span className="text-muted-foreground">…</span>
) : isUser ? (
message.text
) : (
// Assistant text is MARKDOWN. The model emits **bold**, `code`, bullets
// and fenced blocks on nearly every turn, and rendering it literally is
// why the thread read as unfinished — a wall of asterisks and backticks.
// mdToHtml escapes first and emits a fixed tag set (see md.test.ts),
// which is what makes dangerouslySetInnerHTML defensible on text that is
// model output, i.e. untrusted.
// USER text stays literal on purpose: someone typing ** means **.
// whitespace-normal because mdToHtml already turned newlines into <br/>;
// leaving the parent's pre-wrap on would double every line break.
<span
className="block min-w-0 whitespace-normal [overflow-wrap:anywhere] [&_code]:font-mono [&_pre]:break-words [&_pre]:whitespace-pre-wrap [&_pre]:[overflow-wrap:anywhere] [&_strong]:font-semibold"
dangerouslySetInnerHTML={{ __html: mdToHtml(message.text) }}
/>
)}
</div>
{message.text ? (
<div className={cn("mt-0.5 flex", isUser ? "justify-end" : "justify-start")}>
{time ? <span className="flex h-8 items-center [@media(pointer:coarse)]:h-11 text-[10px] leading-none text-muted-foreground">{time}</span> : null}
<CopyButton value={message.text} label="message" />
</div>
) : null}
</div>
</div>
</div>
);
});