Hudson Documentation

Hudson is a multi-app canvas workspace for building and composing AI-native applications. Apps are spatial — they live on an infinite canvas with pan, zoom, and windowing built in. You write a React component, Hudson gives it a window.

Getting Started

Learn what Hudson is, how the architecture works, and build your first app. The core idea is simple: every app is a Provider that exposes slots and hooks. The shell reads from those hooks and renders your UI into windows on a shared canvas.

Overview What Hudson is and why it exists Quickstart Get running locally in under 5 minutes Architecture Project structure and design decisions Building Apps The Provider + Slots + Hooks pattern API Reference Complete reference for @hudson/sdk

NPM Packages

Hudson ships two packages on npm. The SDK gives you types, hooks, and utilities for building apps that plug into any Hudson workspace. HX is a local service registry and smart router that lets apps discover and talk to each other.

@hudsonos/sdk Types, hooks, and utilities for app developers @hudsonos/hx Service registry and smart router

CLI Tools

Command-line tools for scaffolding new apps and running local development servers. The scaffolder generates a full app skeleton with the right file structure and types. Relay is a terminal server that bridges shell sessions into the workspace.

create-hudson-app Scaffold a new Hudson app Relay Terminal server for workspace integration

Prompts

Structured prompts you can feed to an AI agent to generate Hudson apps and features. These are tested prompt templates that produce working code following Hudson conventions.

Create a New App Prompt template for generating a full app Add Intents Prompt template for adding inter-app intents