Getting started

Blacksite UI is a Palantir-inspired component registry that plugs into the official shadcn CLI. You install components into your codebase — no runtime dependency, no opaque library.

01 / Bootstrap a Next.js + shadcn app

npx create-next-app@latest my-ops-app
cd my-ops-app
npx shadcn@latest init

02 / Install the Blacksite theme

npx shadcn@latest add https://blacksite.sh/r/theme.json

This drops Palantir-inspired CSS variables, font families and status colors into your globals.css.

03 / Add a component

# Single component
npx shadcn@latest add https://blacksite.sh/r/stat-card.json

# The full Foundry-style Object Explorer dashboard block
npx shadcn@latest add https://blacksite.sh/r/dashboard-ops.json

04 / Import

import { StatCard } from "@/components/ui/stat-card";

export default function Page() {
  return <StatCard label="Cake" value="ACTIVE" status="active" />;
}

Conventions

All components live under @/components/... after install (you can re-alias in components.json).
Status surfaces use the StatusBadge primitive — the same status keys flow through every component.
Mono fonts are reserved for labels, axis ticks, kbd and codes. Sans-serif for body and values.
Charts and maps are pure React; no global state or theme provider required.

Keyboard

⌘Kopens the search palette in the demo app.