Getting started
NudgeKit UI. One look for every NudgeKit product.
NudgeKit UI is a shadcn registry, not an npm package. The CLI copies each component into your app and the code is yours. It needs React 19, Tailwind v4 and shadcn set up with npx shadcn@latest init.
With your AI agent
The quickest way. This installs two skills into Claude Code, Cursor, Codex and most other agents: one teaches the look and the components, the other reviews work against the rules. Then ask your agent for the page you want.
$ npx skills add https://ui.nudgekit.appBy hand
1. Add the registry to components.json
components.json{ "registries": { "@nudgekit": "https://ui.nudgekit.app/r/{name}.json" } }2. Install the theme: tokens, Inter and JetBrains Mono, and the headline, tone and eyebrow utilities. Install it first: when it only arrives as a dependency of another item, it adds the NudgeKit tokens but keeps shadcn's default colours.
$ npx shadcn@latest add @nudgekit/nudgekit3. Add components and blocks
$ npx shadcn@latest add @nudgekit/button @nudgekit/hero @nudgekit/pricingOr by URL with no config:
npx shadcn@latest add https://ui.nudgekit.app/r/button.json
Moving an existing product over
The rules
The components already follow them. These are for the pages you build around them.
- 01
Light is the default.
White page and navy text (#0B1F33). The soft three-colour Glow sits behind the hero only, and once more in the closing CTA panel.
- 02
Headlines are medium and two-tone.
Inter at weight 500 with -0.03em tracking (the headline utility). A full navy first sentence, then a grey <Tone> phrase. At most one Tone per heading. Never go bolder than 500 for a headline.
- 03
Purple means action.
Stripe purple #533AFD is for the single primary button on a screen, links, focus rings, selected states and the viewfinder corners. Never for headings, body text, card fills or decoration.
- 04
One primary button per screen.
Every other button is secondary (white with a hairline) or ghost. In pricing, only the recommended plan gets the primary button.
- 05
No drop shadows.
Depth comes from 1px #E5EAF0 hairlines and the soft #F6F8FB surface. Nothing lifts on hover: buttons change colour, links change colour, arrows slide 2px.
- 06
Status is text colour.
Green #12805C, amber #B45309, red #C8322B, as a word with a dot (<Status>). No filled status pills, no coloured card borders, no coloured alert backgrounds.
- 07
Greys stay readable.
Supporting text is #475569 (muted-foreground) and faint text is #5F6E82. Nothing lighter for text. Every text passes WCAG AA on white and on the soft surface.
- 08
One signature per page.
The Viewfinder frames the hero media. Do not scatter corners, badges or tilted cards around it.
- 09
Corners are small and consistent.
Buttons and inputs 4px, panels 12px, cards 16px, chips and badges fully round.
- 10
Copy is plain.
Sentence case everywhere, no all-caps eyebrows, no em dashes, no exclamation marks. Say what it does.
- 11
Motion is quiet.
150 to 250ms colour transitions. Everything respects prefers-reduced-motion.
Tokens
Every colour and radius comes from these variables, generated from one file (registry/tokens.json). Use the Tailwind names (bg-surface, text-faint, border-border, text-brand-ink), never raw hex values.
brand
#533AFD
brand-ink
#4434D4
brand-tint
#EFEDFF
foreground
#0B1F33
muted-foreground
#475569
faint
#5F6E82
surface
#F6F8FB
border
#E5EAF0
line-strong
#D3DBE5
success
#12805C
warning
#B45309
danger
#C8322B
glow-1
#7DD3FC
glow-2
#C4B5FD
glow-3
#F9A8D4
:root {
--radius: 0.25rem;
--card-radius: 1rem;
--background: #FFFFFF;
--foreground: #0B1F33;
--card: #FFFFFF;
--card-foreground: #0B1F33;
--popover: #FFFFFF;
--popover-foreground: #0B1F33;
--primary: #533AFD;
--primary-foreground: #FFFFFF;
--secondary: #F6F8FB;
--secondary-foreground: #0B1F33;
--muted: #F6F8FB;
--muted-foreground: #475569;
--accent: #EFEDFF;
--accent-foreground: #4434D4;
--destructive: #C8322B;
--border: #E5EAF0;
--input: #D3DBE5;
--ring: #533AFD;
--brand: #533AFD;
--brand-ink: #4434D4;
--brand-tint: #EFEDFF;
--surface: #F6F8FB;
--faint: #5F6E82;
--line-strong: #D3DBE5;
--ink: #0B1F33;
--success: #12805C;
--warning: #B45309;
--danger: #C8322B;
--glow-1: #7DD3FC;
--glow-2: #C4B5FD;
--glow-3: #F9A8D4;
}