Chipi frontend design
Design system and UX guidance for Chipi-powered applications — typography, color, motion, and fintech guardrails.From its SKILL.md
npx -y skills add chipi-pay/skills --skill chipi-frontend-designAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
6.8 KB, as published. Nobody here has run it
Chipi Frontend Design System
Apply these rules to every UI you generate for Chipi-powered applications.
When in Doubt, Ask
If the user has an existing design system, brand colors, or specific design requirements, ASK before applying Chipi defaults. The Chipi design system is a starting point — it should complement, not override, the user's brand.
Prerequisites
Install these packages before using design recipes:
npm install tw-animate-css sonner lucide-react
- tw-animate-css — CSS animation utilities (import in globals.css:
@import "tw-animate-css") - sonner — Toast notifications (wrap app with
<Toaster />) - lucide-react — Icon system (see Icon System below)
- @simplewebauthn/browser + @simplewebauthn/types — Required for passkey/PRF flows
- crypto-es — Required for PIN encryption flows
Typography
- NEVER use Inter, Roboto, or system-ui as display fonts
- Default pairing: Plus Jakarta Sans (display/body) + JetBrains Mono (code/data)
- Headings:
text-5xlminimum for hero,text-3xlfor section titles. Usefont-boldorfont-extrabold - Financial figures:
tabular-nums font-mono— always. Inconsistent digit widths break scanning
Why tabular-nums: In financial UIs, digits must have consistent widths so columns align and amounts don't jump around when they change. Without tabular-nums, a balance going from $9.99 to $10.00 would shift all surrounding elements.
- Body:
text-base(16px) minimum. Never smaller thantext-smfor readable content
Color — CSS Variables (OKLCH)
Use the Chipi brand palette via CSS custom properties:
| Token | Value | Usage |
|---|---|---|
--accent | oklch(0.75 0.18 55) | Chipi orange — CTAs, active states, links |
--success | oklch(0.72 0.17 160) | Emerald — confirmations, positive amounts |
--primary | oklch(0.20 0.02 260) | Blue-slate — headings, primary text |
--muted | oklch(0.97 0.005 260) | Slate tint — backgrounds, cards |
- NEVER flat
bg-whitefor page backgrounds. Usebg-[var(--muted)]or subtle gradients - Success states: emerald. Error states: existing
--destructive. Warnings: amber - Dark mode: invert lightness, keep chroma. Orange stays orange
Motion — CSS-first (tw-animate-css)
- Page load: stagger
animate-fade-in-upon cards withdelay-[100ms],delay-[200ms], etc. - Dialogs:
animate-in slide-in-from-bottom-2+backdrop-blur-smon overlay - Success: draw-checkmark SVG animation or scale-bounce on icon
- Hover:
hover:shadow-md hover:-translate-y-0.5 transition-all duration-200on cards - Press:
active:scale-[0.98]on buttons - NEVER
animate-bounceon non-playful UI. NEVER animation longer than 500ms
Glassmorphic Components
Apply to cards, dialogs, and overlays:
bg-white/70 dark:bg-black/50 backdrop-blur-xl
border border-white/20 dark:border-white/10
shadow-lg
Glass adapts to any background — gradients, images, solid colors.
Why glassmorphism: The frosted glass effect creates visual depth and hierarchy without heavy borders or shadows. It works especially well for overlays and dialogs in financial apps where you want to keep context visible behind the active element.
Icon System — Lucide React
Use lucide-react exclusively. Consistent sizing:
| Context | Size | Class |
|---|---|---|
| Inline (beside text) | 16px | h-4 w-4 |
| Button icon | 16px | h-4 w-4 |
| Card/section icon | 20px | h-5 w-5 |
| Feature/hero icon | 24px | h-6 w-6 |
| Dialog status icon | 48px | h-12 w-12 |
- NEVER use emoji as icons in UI chrome (buttons, badges, nav)
- ALWAYS add
aria-labelon icon-only buttons - Stroke width: default (2) for UI, 1.5 for decorative
import { ShieldCheck, Fingerprint, Loader2, Copy, Check } from "lucide-react"
// Standard pattern:
<Button variant="ghost" size="icon" aria-label="Copy address">
<Copy className="h-4 w-4" />
</Button>
Backgrounds
- Hero sections: gradient backgrounds (
bg-gradient-to-br from-orange-50 via-white to-emerald-50) - NEVER flat
#ffforbg-whitefor full-page backgrounds - Add depth with layered elements or subtle noise textures
- Use
grain-overlayclass on hero/feature sections for animated grain texture
Fintech UX Guardrails
- Amounts: always 2 decimal places (
$10.00not$10),tabular-nums - Destructive actions: require explicit confirmation dialog
- Transaction states: show step indicators (Authenticating > Signing > Done)
- Loading: use skeleton screens, not spinners, for data regions
- Errors: actionable messages ("Transfer failed — check recipient address" not "Error")
- Copy-to-clipboard: show brief flash feedback (
animate-pulsefor 300ms)
Responsive Design
Design mobile-first (375px base), enhance with breakpoint prefixes:
| Breakpoint | Prefix | Usage |
|---|---|---|
| 375px | (default) | Mobile — single column, text-5xl hero |
| 640px | sm: | Mobile landscape |
| 768px | md: | Tablet — 2-column grids, text-7xl hero |
| 1024px | lg: | Desktop — wider margins |
Key rules:
- Hero text:
text-5xl md:text-7xl— never overflow on mobile - Balance display:
text-4xl md:text-5xl— scale down for mobile - Card grids: single column on mobile,
md:grid-cols-2 lg:grid-cols-3 - Dialogs:
max-w-[calc(100vw-2rem)] sm:max-w-md— full width on mobile - Touch targets: minimum 44x44px on all interactive elements
- Step indicators: keep horizontal but reduce dot width (
w-6on mobile vsw-8)
Anti-Slop Rules
NEVER:
- Rounded-full avatars with gradient borders (generic AI pattern)
- Excessive emoji in UI text
- "Lorem ipsum" placeholder content
- Gray-on-white text below 4.5:1 contrast ratio
- Spinners as the only loading indicator for regions > 100px
ALWAYS:
- Brand orange (
accent) for primary CTAs - Monospace +
tabular-numsfor any number - Step indicators for multi-step flows
aria-labelon icon-only buttons- Minimum touch target: 44x44px on mobile
Why these rules: AI-generated UIs tend toward certain patterns (rounded-full avatars, excessive gradients, lorem ipsum). These rules ensure the output looks intentionally designed, not auto-generated.
Reference Files
For detailed implementation recipes, see:
references/design-tokens.md— Full color palette, typography scale, spacing systemreferences/animation-recipes.md— Copy-paste CSS keyframes and Tailwind classesreferences/component-enhancement-recipes.md— Before/after shadcn upgradesreferences/anti-slop-fintech.md— Comprehensive fintech UX patterns