Skip to content

LedgerHQ/lumen / .claude/skills/component-styling

component-styling

Verified

Use when building or styling a component in libs/ui-react or libs/ui-rnative — the cross-platform styling principles, plus routing to the platform mechanics: Tailwind + cva + cn on web, useStyleSheet + themeJS + lx on React Native. Load this before writing component styles.

Component styling

Lumen ships the same components on web and React Native. The vocabulary of design tokens is shared across both (bg-muted ↔ t.colors.bg.muted); the mechanism is not. This skill states the principles that hold on both platforms, then routes you to the platform mechanics.

Route by lib

Derive the touched lib from the path (see the Libraries table in AGENTS.md), then read the matching reference:

LibRead
libs/ui-reactreferences/react.md (Tailwind + cva + cn)
libs/ui-rnativereferences/rnative.md (useStyleSheet + themeJS + lx)

Never apply one platform's mechanics to the other lib. A className on an RN file or a useStyleSheet call on a web file is always wrong.

Shared principles (both platforms)

These hold regardless of mechanism — the references show how each realises them.

  • Design tokens, never raw values. Colours, typography, spacing and sizes come from the design system, not from raw Tailwind palette classes / arbitrary sizes (web) or hardcoded literals (RN). The token catalogues live in references/*.
  • Props-drill to the top-level element. Behaviour must never be hidden. When a prop legitimately targets a nested element (a nested ref, className, or style), give it a distinct name (contentClassName, inputStyle) rather than overloading the top-level prop.
  • Compose variants declaratively. Appearance / size / state maps are declared once at the top of the styling layer (cva on web, Record<Variant, value> inside useStyleSheet on RN), never assembled ad hoc in the render body.
  • Never build a style value by concatenation. text-${color} and its RN equivalents are wrong — use complete token strings and a merge helper (cn on web, StyleSheet.flatten on RN).

Review checks

Rules verifiable from a diff. Lint already covers unknown/invalid Tailwind classnames, banned imports and formatting — see the "already enforced" list in pr-review; don't raise those here.

CheckApplies toDetectSkip
Raw Tailwind value instead of a tokenreacttext-gray-, bg-blue-, font-bold, text-sm, w-[, h-[.mdx doc-table markup
Dynamic classname built by concatenationreactclassName={`...${ `—
Classnames in a bare string variable instead of cn() / cva()reactconst … = 'flex …' outside a cn( / cva( callstrings inlined in className
cva skipped where variants/many classes exist (or forced for 1–2 classes)reactinline variant branching in JSX—
data-[state=…] on a Base UI primitive (or data-[open] on a Radix one)reactimport source vs attribute form—
Hardcoded colour/spacing/size literal instead of a t.* tokenrnativenumeric or '#…' inside useStyleSheetgeometry constants under Components/visualization/
Large stylesheet inlined in the component body instead of a useXStyles hookrnativeuseStyleSheet call inline in the componentsmall one-off styles
Consumer style/lx merged before internal styles (consumer can't win)rnativeflatten([style, styles.root]) (reversed order)—
Nested override overloads the top-level prop instead of a distinct namebothone className/style prop feeding an inner element—
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 318kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 196kUpdated Claude CodeCodexVerifiedInstall