---
name: nudgekit
description: The NudgeKit UI design system (ui.nudgekit.app), a light Stripe-inspired look - white page, navy text, medium-weight Inter 500 two-tone headlines with a grey Tone phrase, Stripe purple #533AFD for the one primary action, 1px hairline borders and no drop shadows, viewfinder corners around the hero media. Use when building or restyling UI for any NudgeKit product (nudgekit.app, its subdomains, the screenshot API), when the user mentions NudgeKit UI, @nudgekit, or "the nudgekit look/style", and when adding @nudgekit components with the shadcn CLI.
---

# NudgeKit UI

Build every NudgeKit screen from the `@nudgekit` shadcn registry and follow the rules below. Prefer installing a registry item over writing your own version of it.

Docs: https://ui.nudgekit.app · Map of every item: https://ui.nudgekit.app/llms.txt

## Setup (once per project)

Needs React 19, Tailwind v4 and shadcn (`npx shadcn@latest init`). Add the registry to `components.json`:

```json
{ "registries": { "@nudgekit": "https://ui.nudgekit.app/r/{name}.json" } }
```

Then install the theme first, before any component. It replaces shadcn's default colours and brings the tokens, Inter, JetBrains Mono and the `headline`, `tone` and `eyebrow` utilities:

```bash
npx shadcn@latest add @nudgekit/nudgekit
```

Add items by name: `npx shadcn@latest add @nudgekit/button @nudgekit/hero`. Each item pulls in what it depends on.

For links that look like buttons, use `<a className={buttonVariants({ variant: "secondary" })}>`, not `<Button asChild>`: it works with every shadcn style, including Base UI projects.

## The rules

1. **Light is the default.** White page, navy text. The `<Glow>` sits behind the hero only, and once in the closing `<CtaPanel>`.
2. **Medium two-tone headlines.** Use the `headline` utility (Inter 500, -0.03em). Write a full navy first sentence, then put the second phrase in `<Tone>`. One Tone per heading. Never bold (600+) a headline, and never thin (300) either.
3. **Purple means action.** `bg-primary` / `text-brand-ink` only for the primary button, links, focus, selection and the viewfinder. Never for headings, paragraphs, card fills or decoration.
4. **One primary button per screen.** Everything else is `variant="secondary"` or `"ghost"`. In pricing only the recommended plan is primary.
5. **No drop shadows.** No `shadow-*`, no `drop-shadow`. Depth comes from `border-border` hairlines and `bg-surface`. Nothing moves up on hover.
6. **Status is text colour.** Use `<Status tone="ok|warn|bad">`. No filled status pills, no coloured card borders, no coloured alert backgrounds.
7. **Readable greys only.** Supporting text is `text-muted-foreground` (#475569), faint text is `text-faint` (#5F6E82). Never `text-gray-400` or lighter, never opacity on text.
8. **One viewfinder per page,** around the hero media. Nothing floating or tilted around it.
9. **Corners:** buttons and inputs `rounded-md` (4px), panels `rounded-xl` (12px), cards `rounded-card` (16px), chips and badges `rounded-full`.
10. **Copy is plain.** Sentence case, no all-caps eyebrows, no em dashes, no exclamation marks.
11. **Motion is quiet.** 150-250ms colour transitions, always with `motion-reduce` handling.

## Tokens

Use Tailwind names, never raw hex: `bg-background`, `text-foreground`, `text-muted-foreground`, `text-faint`, `bg-surface`, `border-border`, `border-line-strong`, `bg-primary`, `text-brand-ink`, `bg-brand-tint`, `text-success`, `text-warning`, `text-danger`, `bg-ink` (code panels). The full list is in `references/tokens.css`.

## Page recipe

A product landing page, top to bottom: `Navbar` → `Hero` (media inside `BrowserFrame`) → `LogoStrip` → `SectionHead` + `FeatureBento` → `SectionHead` + `Steps` beside `CodeBlock` → `StatStrip` → `Pricing` → `CtaPanel` → `Footer`. The `landing-page` item is this recipe assembled; install it and edit the copy.

```tsx
<h1 className="headline text-[44px]">
  The screenshot API for developers. <Tone>Any URL to image, PDF or markdown in one call.</Tone>
</h1>
```

See `references/components.md` for every item, its props and an example.
