Spawn Partners — Design System

The single source of truth for the Spawn Partners brand, shipped as @spawn-llc/design-system — a React component library built on Base UI primitives, themed from the brand tokens, plus the raw tokens and logo assets. Editorial, founder-led, technical: white base, ink text, a single clay-red accent used as a highlighter — never a theme color. Light mode only; there is no dark theme and nothing to configure.

Install

pnpm add @spawn-llc/design-system

Peer dependencies: react and react-dom (18.2+ or 19).

Import the stylesheet and the self-hosted fonts once at your app entry:

import "@spawn-llc/design-system/styles.css"
import "@spawn-llc/design-system/fonts"

Then use components and icons:

import { Button, Card } from "@spawn-llc/design-system"
import { CheckIcon, MagnifyingGlassIcon } from "@spawn-llc/design-system/icons"

export function Example() {
  return <Button>Get started</Button> // ink by default; clay is reserved
}

The package is the icon source — the full Phosphor set, tree-shakeable, at regular weight. Do not add lucide-react or @phosphor-icons/react to a Spawn app; a second icon set is the same class of error as a second palette.

Tailwind v4 consumers can import the theme instead of the prebuilt stylesheet:

@import "tailwindcss";
@import "@spawn-llc/design-system/theme.css";
@source "../node_modules/@spawn-llc/design-system/dist";

Raw tokens are exported directly: @spawn-llc/design-system/tokens.css and @spawn-llc/design-system/tokens.json.

The one rule

Marketing is editorial — Newsreader headlines, full volume. Product UI is calm — Geist everywhere, soft borders, no serif. Clay marks exactly one element per view.

Where everything lives

• SPEC.md — the full brand contract. Read this first.
• llms.txt — the LLM-facing summary: brand rules plus a component index, generated, shipped in the package and served at the deployed playground root.
• PDFS.md — the report tier: print.css, the @spawn-llc/design-system/pdf vocabulary, and the render — an importable server-side renderReportPdf from @spawn-llc/design-system/pdf/render for on-demand generation, with the spawn-design-system pdf <url> CLI as a wrapper.
• Playground — the deployed reference, rebuilt on every push to main: https://design-system-production-0a0e.up.railway.app. Run it locally with pnpm run play.

Deploying is not releasing, and pushing is not publishing — the npm publish is triggered only by a vX.Y.Z tag.

License

MIT © Spawn Partners.