# Vernmarck (@freshgemui/vernmarck) > Architectural, single-polarity monochrome design system built on 12-step Radix contrast math, strict semantic tokens, and a calibrated density axis. - Website: https://vernmarck.freshgemui.com/ - Full AI Reference: https://vernmarck.freshgemui.com/llms-full.txt - Package: `@freshgemui/vernmarck` (v0.1.0, MIT) ## Installation & Entrypoints ```bash npm install @freshgemui/vernmarck ``` - Components & Types: `import { Button, Input, Card, ... } from "@freshgemui/vernmarck"` - Tailwind v4 Bridge CSS: `@import "@freshgemui/vernmarck/styles.css";` - Standalone Primitive Tokens: `@import "@freshgemui/vernmarck/tokens/primitives.css";` - Standalone Semantic Tokens: `@import "@freshgemui/vernmarck/tokens/semantic.css";` ## Core Architecture - **Polarity**: Ghost White (light default, `:root` / `.light`) <-> Sable (dark, `.dark`) - **Functional Signals**: `info` (Blue), `warning` (Orange), `destructive` (Red), `success` (Green) — used only when user attention is required. - **Calibrated Density**: `data-density="default"` (36px controls, editorial comfort) | `data-density="compact"` (28px controls, high-density instrument calibration) - **Token Discipline**: Zero raw hex values, zero raw Radix step numbers in components, zero generic Tailwind grays (`gray-*`, `slate-*`, `zinc-*`, `neutral-*`, `stone-*`). ## Semantic Tokens `background`, `foreground`, `card`, `card-foreground`, `popover`, `popover-foreground`, `primary`, `primary-hover`, `primary-foreground`, `secondary`, `secondary-hover`, `secondary-foreground`, `muted`, `muted-foreground`, `accent`, `accent-foreground`, `border`, `input`, `ring`, `info`, `warning`, `destructive`, `success` (each signal includes `-hover`, `-foreground`, `-subtle`, `-subtle-foreground`). ## 6 Foundations 1. Scale & Density (`[data-density="default"]` / `[data-density="compact"]`) 2. Color & Contrast (Ghost White <-> Sable 12-step Radix scales, WCAG AA >= 4.5:1) 3. Typography (`Geist` sans + `Geist Mono` + `tabular-nums` on tables/metrics) 4. Spacing (4px base grid: `--space-1`..`--space-6`, `--space-8`, `--space-10`, `--space-12`) 5. Border Radius (`--radius-none`, `--radius-sm`, `--radius-md`, `--radius-lg`, `--radius-full`) 6. Borders & Elevation (1px hairline `border` discipline: `background` -> `card` -> `popover`) ## 29 Exported Primitives - **Forms & Controls**: `Accordion`, `Button`, `Checkbox`, `Field`, `Input`, `RadioGroup`, `Select`, `Slider`, `Switch`, `Textarea`, `ToggleGroup` - **Feedback & Status**: `Alert`, `Badge`, `EmptyState`, `Progress`, `Skeleton`, `ToastProvider` / `Toaster` / `useToast` - **Overlays & Menus**: `AlertDialog`, `Command`, `Dialog`, `DropdownMenu`, `Popover`, `Sheet`, `Tooltip` - **Layout & Data**: `Breadcrumb`, `Card`, `DataTable`, `Separator`, `Tabs`