byronwade/ui

Foundation · Installation

Two commands to a wired system.

shadcn CLI · Next.js + Tailwind v4. The code is copied into your repo, no runtime dependency, fully yours.

shadcn
$ npx shadcn@latest init …/foundation.json
✓ foundation installed, :root tokens ready

$ npx shadcn@latest add @byronwade/all
✓ added the full catalog, deps resolved

The fast path

1

Initialize against the foundation base

The foundation owns your :root tokens and Tailwind theme. Run init on a fresh Next.js app (created with --tailwind).

2

Register the @byronwade namespace

Add one line to components.json so the CLI resolves @byronwade/*.

3

Add the catalog, or just what you need

Everything at once, or only the pieces you want, transitive deps come along (activity-ring pulls status-dot + utils).

Add a component

One command per component, each page has a copy button. Or point at a built URL with no namespace, and keep your AI agent on-system as it adds them.

Manual setup

Don't run init on an existing theme , it overwrites globals.css. Merge the foundation cssVars by hand, keep --ring/--chart-1/--success deriving from var(--brand), then add components.