Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content
Ploxum UI

ploxum

Ploxum UI — The UI for your Command Center.

See it live

Cinematic dark-mode operational intelligence UI library. Modeled on RuixenUI, MUI Material, and Minimals UI. Designed to compose around a focal canvas — the venue map of an event command center, a video grid, a mission view — and never to absorb it.

Why ploxum exists

Most "dashboard kits" optimize for marketing screenshots, not 8-hour operator shifts. ploxum optimizes for three things, in this order:

  1. Cognitive load over 8-hour shifts. Fixed zones. Predictable shapes. No layout drift.
  2. Decisions made in under 3 seconds during incidents. P1 banners are motionless and immediate. Command palette reaches any action in two keystrokes.
  3. Trust through traceability. Every state is timestamped. Every metric has a "why" tooltip. Every dispatch action is logged.

Get started

pnpm add @roger-emerson/ploxum-primitives @roger-emerson/ploxum-tokens

Or copy composites in source form (shadcn-style):

npx ploxum init
npx ploxum add kpi-strip alert-center command-shell

Wrap your app:

import { PloxumProvider, ThemeSwitcher, ModeToggle } from '@roger-emerson/ploxum-primitives';
import '@roger-emerson/ploxum-tokens/css';
import '@roger-emerson/ploxum-tokens/themes/cinematic.css';
import '@roger-emerson/ploxum-tokens/themes/amber-minimal.css';
 
export function App({ children }) {
  return (
    <PloxumProvider theme="cinematic" mode="system" density="comfortable">
      {children}
    </PloxumProvider>
  );
}

See Getting started for the full walkthrough, Themes for the two-layer token model + tweakcn adapter recipe, and Components for the catalog.

What ploxum is not

  • A general-purpose dashboard kit. The components are tuned for high-stakes operational surfaces where cognitive load and decision latency matter more than visual novelty.
  • A theme of shadcn/ui. The two-layer token model accepts tweakcn themes, but the cinematic theme + the operational primitives (KpiTile with tabular numerals, StatusPip with shape+color, AlertCard with severity+status) are designed for command-center UX, not marketing landing pages.
  • A replacement for the focal canvas. ploxum composes around a venue map, video grid, or mission view; it never absorbs the focal canvas itself.