Hudson is a shell and primitives library for composing canvas workspaces and single-app dashboards. Provider + Slots + Hooks — apps own state, the shell renders chrome.
Every Hudson app implements a single TypeScript interface. The shell reads your Provider, slots, and hooks — and renders the rest.
interface HudsonApp {
id: string;
name: string;
Provider: React.FC;
slots: { Content, LeftPanel?, Inspector? };
hooks: { useCommands, useStatus, ... };
}Each app is a React Provider. The shell nests providers and renders slots.
Apps declare what they want in the nav, side panels, overlays. The shell composes.
Implement HudsonApp and you get chrome, windows, intents, and AI for free.
Pan, zoom, and windowed apps on an infinite plane. Or static panels for dashboards.
Bottom drawer ships with Hudson AI and an embedded PTY terminal.
Command palette, focus model, hold-space pan — designed for power users.
For most consumers. A polished frame around one HudsonApp — nav, sidebar, status bar. Use when you're shipping a focused tool.
Infinite pan/zoom plane with windowed apps. Used by Hudson's own /app route. Use when the interface is the environment.
Implement the HudsonApp interface and plug into any workspace
export interface HudsonApp {
id: string;
name: string;
description?: string;
mode: 'canvas' | 'panel';
Provider: React.FC<{ children: ReactNode }>;
slots: {
Content: React.FC;
LeftPanel?: React.FC;
Inspector?: React.FC;
Terminal?: React.FC;
};
hooks: {
useCommands: () => CommandOption[];
useStatus: () => { label: string; color: StatusColor };
useSearch?: () => SearchConfig;
};
}Get notified when the Hudson SDK is available for building your own apps.