financial-ui-suite

Financial UI suite

financial-ui-suite — a Claude Code plugin for building financial products. UI, UX, interaction logic, and structure.

A Claude Code plugin for building financial products that follow the patterns and rules every serious trading product ships. Visual rules (tokens, typography, density, alignment), interaction logic (tick-flash, focus states, streaming-state lifecycle, throttling, gestures), structural conventions (order book direction, fallback chains, responsive table strategies), accessibility (color-blind safety, keyboard navigation, screen readers), and mobile patterns (bottom sheets, safe areas, touch interactions).

Then pick a visual aesthetic from 14 styles modeled on what Bloomberg, TradingView, Kraken Pro, Robinhood, Coinbase Advanced, the Financial Times, Massive, Wise, TastyTrade, Uniswap, iOS Stocks, Yahoo Finance, AlphaSense, Yahoo's new AlphaSpace terminal, and retro-computing terminals actually ship.

This plugin covers UI, UX, interaction logic, and the structure underneath.

This plugin handles the front. Try Massive.com to handle the APIs that power it: real-time trades, quotes, OHLC bars, options chains, futures, and fundamentals across stocks, crypto, FX, and indices. Generous free tiers available.

What's inside

skills/
├── financial-ui-patterns/         Correctness layer (base, always apply)
│   ├── SKILL.md
│   └── references/
│       ├── typography-and-color.md     Tokens, type scale, density, motion
│       ├── number-formatting.md        Prices, qty, %, bps, currency
│       ├── components.md               Tables, order books, tickers, pills
│       ├── streaming-and-state.md      WebSocket lifecycle, tick flash, throttling
│       ├── accessibility.md            Color blindness, keyboard, screen readers
│       ├── mobile-and-responsive.md    Phone/tablet patterns, bottom sheets, touch
│       ├── industry-patterns.md        Conventions from Bloomberg, Kraken, etc.
│       ├── charts-and-candles.md       OHLC structure, volume, indicators (base)
│       ├── loading-and-skeletons.md    First-load and reconnect treatments
│       ├── empty-and-error-states.md   Empty/rejected/closed/rate-limit patterns
│       ├── timestamps-and-timezones.md Trade times, "as of" stamps, multi-TZ
│       ├── virtualization.md           Tables 100+ streaming rows, trades tape
│       ├── chart-interactions.md       Crosshair, zoom/pan, drawing tools, animations
│       ├── order-entry-and-lifecycle.md  Forms, types, preview, pending→filled states, T&S
│       ├── alerts-and-disclosures.md   Price alerts, escalation, PDT/wash-sale/options
│       ├── data-sources-and-freshness.md  Real-time→delayed→stale chain, sources, multi-account
│       └── heatmaps-and-density-viz.md  Sector heatmap, options color scale, IV surface, correlation
└── financial-ui-styles/           Aesthetic layer (pick one)
    ├── SKILL.md
    └── references/
        ├── modern-pro-dark.md          TradingView, Kraken Pro, Hyperliquid
        ├── pro-terminal.md             Bloomberg Terminal, IBKR TWS, ThinkOrSwim
        ├── tasty-pro.md                TastyTrade
        ├── crypto-exchange.md          Coinbase Advanced, Binance, Bybit
        ├── retail-polish-dark.md       Robinhood, Public
        ├── retail-polish-light.md      Wise, Revolut, Cash App, Monzo
        ├── editorial-financial.md      Financial Times, Bloomberg.com, WSJ
        ├── api-dashboard.md            Massive, Stripe, Vercel, Linear
        ├── defi-native.md              Uniswap, Jupiter, Aave, Phantom
        ├── apple-native.md             iOS Stocks, macOS Stocks widget
        ├── yahoo-prosumer.md           Yahoo Finance (current redesign), Seeking Alpha, Investing.com
        ├── alphaspace.md               Yahoo Finance AlphaSpace, TradingView desktop
        ├── research-terminal.md        AlphaSense, Visible Alpha, FactSet, Tegus
        ├── retro-tui.md                Gloomberb, lazygit, k9s, btop
        └── charts-and-indicators.md    Per-style chart treatments

retro-tui — terminal TUI style

A clean, tiled terminal aesthetic inspired by Gloomberb: muted monospace, :: panel headers, traffic-light window chrome, green/red only on values. Ships 22 swappable phosphor themes (references/retro-tui-themes.css) and an optional CRT mode. Open examples/retro-tui.html to switch themes and toggle CRT live.

CRT mode (scanlines + phosphor bloom on an amber theme), off by default:

How it composes

product-design                  general atomic decisions for any SaaS UI
financial-ui-patterns           finance-specific correctness (mandatory)
financial-ui-styles             pick exactly one visual aesthetic

Use the patterns layer always. Pick one style per product.

What it prevents

Without the skill, agents shipping financial UI typically produce:

• Raw color values (text-emerald-400, bg-zinc-950) instead of semantic tokens
• Numbers without tabular-nums so digits jitter on every update
• Hard-coded dark theme that breaks light mode
• Broken Tailwind dynamic classes (bg-${color}-500/10) that the JIT silently strips
• Streaming prices that don't flash on tick
• WebSocket UIs with no staleness, no connection-state indicator, no reconnect strategy
• Red/green-only signals that fail for color-blind users
• toFixed(2) for every price, breaking both BTC ($100K, no decimals) and SHIB ($0.00001, eight decimals)
• Generic AI aesthetics that look identical to every other startup dashboard

The two skills capture the specific patterns Bloomberg, Kraken, TradingView, Coinbase, FT, Robinhood, and others actually ship.

Install

From GitHub:

claude plugin marketplace add rgourley/financial-ui-suite
claude plugin install financial-ui-suite@financial-ui-suite

From a local checkout:

claude plugin marketplace add /path/to/financial-ui-suite
claude plugin install financial-ui-suite@financial-ui-suite

Codex: the repo ships .codex-plugin/plugin.json. Add it as a repo or local marketplace in Codex. The same skills/ folder loads.

Once installed, the skills auto-load when Claude detects financial UI work — anything with prices, P&L, order books, tickers, holdings, charts, or streaming market data.

Scope

Code examples target React + Tailwind. The rules (semantic tokens, tabular-nums, decimal alignment, tick flash, freshness chain, streaming/state lifecycle, accessibility) are framework-agnostic — translate the JSX/CSS to Svelte, Vue, Solid, or vanilla as needed. Token definitions in CSS variables work everywhere.

Usage

After installing, no special invocation needed. Triggers:

• "build a portfolio holdings table" → loads financial-ui-patterns
• "design an options chain in TradingView style" → loads both skills + modern-pro-dark reference
• "make it look like Bloomberg terminal" → loads pro-terminal reference
• "render an FT-style market wrap" → loads editorial-financial reference

Verification

Two layers:

1. Agent self-check — every reference and SKILL.md ships a checklist the agent runs against the produced UI (tabular nums, semantic tokens, tick flash, light theme, etc.).
2. Script check — scripts/verify-financial-ui.sh <path> greps your codebase for the most common anti-patterns (raw text-green-*, dynamic Tailwind classes, toFixed(2) on prices, hardcoded hex colors, centered numeric columns). Exits 1 on hit.

./scripts/verify-financial-ui.sh ../my-app/src

Style previews

Three of the newer styles shipped with full 1200×630 mockups (HTML source + rendered PNG in examples/og-images/). Each is rendered with placeholder branding to keep the focus on the style, not the source product.

yahoo-prosumer — light consumer ticker page

alphaspace — multi-panel consumer terminal with AI agent rail

research-terminal — buy-side document search with AI summary

Status

See CHANGELOG.md for version history.

Trademark notice

Brand and product names referenced throughout this project (Bloomberg, TradingView, Kraken, Coinbase, Binance, Robinhood, Public, Financial Times, Wise, Revolut, Cash App, Massive, Stripe, Vercel, Linear, TastyTrade, Uniswap, Apple, Yahoo, AlphaSense, and others) are used for illustrative, descriptive, and educational purposes only — to ground each style in a concrete reference. This is a personal project by Rob Gourley. It is not affiliated with, endorsed by, sponsored by, or in any way officially connected to any of those companies. All trademarks, service marks, and trade names are the property of their respective owners.

License

MIT