agentsclimarketplace

Chipi frontend design

Skill chipi-pay/skills/skills/chipi-frontend-design

Design system and UX guidance for Chipi-powered applications — typography, color, motion, and fintech guardrails.From its SKILL.md

Install
npx -y skills add chipi-pay/skills --skill chipi-frontend-design

Assembled 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-5xl minimum for hero, text-3xl for section titles. Use font-bold or font-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 than text-sm for readable content

Color — CSS Variables (OKLCH)

Use the Chipi brand palette via CSS custom properties:

TokenValueUsage
--accentoklch(0.75 0.18 55)Chipi orange — CTAs, active states, links
--successoklch(0.72 0.17 160)Emerald — confirmations, positive amounts
--primaryoklch(0.20 0.02 260)Blue-slate — headings, primary text
--mutedoklch(0.97 0.005 260)Slate tint — backgrounds, cards
  • NEVER flat bg-white for page backgrounds. Use bg-[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-up on cards with delay-[100ms], delay-[200ms], etc.
  • Dialogs: animate-in slide-in-from-bottom-2 + backdrop-blur-sm on overlay
  • Success: draw-checkmark SVG animation or scale-bounce on icon
  • Hover: hover:shadow-md hover:-translate-y-0.5 transition-all duration-200 on cards
  • Press: active:scale-[0.98] on buttons
  • NEVER animate-bounce on 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:

ContextSizeClass
Inline (beside text)16pxh-4 w-4
Button icon16pxh-4 w-4
Card/section icon20pxh-5 w-5
Feature/hero icon24pxh-6 w-6
Dialog status icon48pxh-12 w-12
  • NEVER use emoji as icons in UI chrome (buttons, badges, nav)
  • ALWAYS add aria-label on 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 #fff or bg-white for full-page backgrounds
  • Add depth with layered elements or subtle noise textures
  • Use grain-overlay class on hero/feature sections for animated grain texture

Fintech UX Guardrails

  • Amounts: always 2 decimal places ($10.00 not $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-pulse for 300ms)

Responsive Design

Design mobile-first (375px base), enhance with breakpoint prefixes:

BreakpointPrefixUsage
375px(default)Mobile — single column, text-5xl hero
640pxsm:Mobile landscape
768pxmd:Tablet — 2-column grids, text-7xl hero
1024pxlg: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-6 on mobile vs w-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-nums for any number
  • Step indicators for multi-step flows
  • aria-label on 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 system
  • references/animation-recipes.md — Copy-paste CSS keyframes and Tailwind classes
  • references/component-enhancement-recipes.md — Before/after shadcn upgrades
  • references/anti-slop-fintech.md — Comprehensive fintech UX patterns

Keep looking

Skills are one crate of 608,475. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.