Communitygithub.com

modern-ui-design

Shows an agent how to art-direct and build "modern ui design" so the concrete output is a design-system pass with tokens. The procedure moves through Modern UI Design System (Brand-Neutral Base), Overview, Visual Philosophy. Use it when a new assignment calls for this craft.

¿Qué es modern-ui-design?

modern-ui-design is a Claude Code agent skill that shows an agent how to art-direct and build "modern ui design" so the concrete output is a design-system pass with tokens. The procedure moves through Modern UI Design System (Brand-Neutral Base), Overview, Visual Philosophy. Use it when a new assignment calls for this craft.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KJ-AIML/rust-product-skills/tree/HEAD/skills/modern-ui-design

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Modern UI Design System (Brand-Neutral Base)

Overview

A clean, modern interface earns trust through restraint: crisp contrast, clear visual hierarchy, predictable interactive states, and zero visual clutter. This skill defines a brand-neutral design foundation—adapt the accent palette and emblem to each product's own identity rather than locking in any fixed brand.

Read the detailed references before styling components:

Visual Philosophy

  1. Dark-First, Dual-Theme Ready: Default to a deep, neutral obsidian canvas (#0F0F0F / oklch neutral dark) rather than muddy navy-grey, with a first-class crisp Light Mode token set (#FAFAFB canvas, #FFFFFF elevated cards) toggled cleanly via .dark / prefers-color-scheme.
  2. Surface Hierarchy via Hairlines & Luminance: Separate layers with 1px low-opacity hairline borders (rgba(255,255,255,0.08) in dark; rgba(15,15,18,0.08) in light) and subtle top inner highlights (inset 0 1px 0)—not heavy drop shadows or cluttered card borders.
  3. Restrained Glass & Ambient Accents: Use backdrop-filter: blur(...) selectively on floating command docks, status pills, and modals so typography always stays crisp. If adding an ambient background texture (subtle radial glow or low-opacity dot-matrix wave), anchor it away from primary text and react calmly to active state.
  4. Crisp Typography & Tabular Figures:
    • Pair a geometric sans (Geist / Inter / Outfit) for UI headings and body with a sharp monospace (IBM Plex Mono / JetBrains Mono) using tabular-nums for IPs, IDs, ports, latencies, quotas, and timestamps.
    • Tighten display headings (tracking-tight), keep body text readable (leading-relaxed), and reserve uppercase micro-labels (text-[11px] tracking-[0.18em]) strictly for section kickers.
  5. Motion with Restraint: Prefer crisp 150ms hover/press feedback and meaningful progress indicators (multi-stage phase steppers) over decorative bounce animations. Always honor @media (prefers-reduced-motion: reduce).

Architecture & Rust Contract Rules

  • Stack: React 19 + TypeScript (strict: true) + Vite + Tailwind CSS v4 (@tailwindcss/vite) + accessible primitives (radix-ui) + lucide-react icons.
  • Single Source of Truth (ts-rs): Never hand-duplicate backend structs in TypeScript. Import generated types directly from src/generated/ produced by cargo run -p xtask -- codegen.
  • Thin Bridge + Preview Fallback: Abstract backend communication behind a tiny Bridge interface (createTauriBridge / createHttpBridge + createPreviewBridge). When opened in a standard browser without the native shell or backend, render an explicit Preview Mode banner with scenario links (ready, empty, missing-dep, blocked, error) so every visual state can be verified cleanly.
  • Safety UX Matches Engine Rules: Destructive actions require an explicit confirmation dialog; blocked states explain which rule blocked them and why—never silently swallow clicks.

Visual Verification Gate

Before marking any UI task done:

  1. Run tsc --noEmit and vite build with zero errors.
  2. Inspect the live rendered app in a browser (desktop width ~1280x900 AND narrow/compact width ~768px) checking:
    • Zero console errors or uncaught promise rejections
    • No wrapping collisions on long values (e.g., IPv6 addresses, long file paths, long titles)
    • Clear contrast on active, disabled, warning, and blocked states
    • Interactive state transitions (loading stepper, copy feedback, modal confirm, empty/error states)

Skills relacionados