设计与 UI
frontend-design
UI component design principles, visual hierarchy, spacing, typography for Next.js apps. Use when building or reviewing React/Next.js components, setting up design tokens, or establishing visual consistency.
sabahattink · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add sabahattink/antigravity-fullstack-hq --skill frontend-design技能说明
name: frontend-design description: UI component design principles, visual hierarchy, spacing, typography for Next.js apps. Use when building or reviewing React/Next.js components, setting up design tokens, or establishing visual consistency.
Frontend Design
Core Design Principles
Visual Hierarchy
Every screen needs a clear reading order. Use size, weight, color, and spacing to guide the eye.
// Good: Clear hierarchy
export function ArticleCard({ title, excerpt, author, date }: ArticleCardProps) {
return (
<article className="rounded-xl border border-gray-100 p-6 shadow-sm hover:shadow-md transition-shadow">
{/* Primary: title grabs attention */}
<h2 className="text-xl font-semibold text-gray-900 leading-snug mb-2">
{title}
</h2>
{/* Secondary: excerpt supports */}
<p className="text-gray-600 text-sm leading-relaxed line-clamp-3 mb-4">
{excerpt}
</p>
{/* Tertiary: metadata recedes */}
<div className="flex items-center gap-2 text-xs text-gray-400">
<span>{author}</span>
<span>·</span>
<time>{date}</time>
</div>
</article>
)
}
Spacing System
Use a consistent spacing scale. Tailwind's default scale (4px base) works well.
// Design token constants — define once, use everywhere
export const spacing = {
xs: 'gap-1', // 4px — tight inline elements
sm: 'gap-2', // 8px — related items
md: 'gap-4', // 16px — section padding
lg: 'gap-6', // 24px — card padding
xl: 'gap-8', // 32px — section gaps
'2xl': 'gap-12', // 48px — page sections
'3xl': 'gap-16', // 64px — hero sections
} as const
// Usage: consistent padding inside cards
function Card({ children }: { children: React.ReactNode }) {
return (
<div className="p-6 rounded-2xl bg-white shadow-sm border border-gray-100">
<div className="flex flex-col gap-4">
{children}
</div>
</div>
)
}
Typography
Font Scale
// tailwind.config.ts — extend the default scale
import type { Config } from 'tailwindcss'
const config: Config = {
theme: {
extend: {
fontSize: {
'display-2xl': ['4.5rem', { lineHeight: '1.1', letterSpacing: '-0.02em' }],
'display-xl': ['3.75rem', { lineHeight: '1.1', letterSpacing: '-0.02em' }],
'display-lg': ['3rem', { lineHeight: '1.2', letterSpacing: '-0.01em' }],
'display-md': ['2.25rem', { lineHeight: '1.2', letterSpacing: '-0.01em' }],
'display-sm': ['1.875rem',{ lineHeight: '1.3' }],
'body-xl': ['1.25rem', { lineHeight: '1.75' }],
'body-lg': ['1.125rem',{ lineHeight: '1.75' }],
'body-md': ['1rem', { lineHeight: '1.6' }],
'body-sm': ['0.875rem',{ lineHeight: '1.5' }],
'body-xs': ['0.75rem', { lineHeight: '1.5' }],
},
fontFamily: {
sans: ['var(--font-inter)', 'system-ui', 'sans-serif'],
mono: ['var(--font-fira-code)', 'monospace'],
},
},
},
}
export default config
Loading Fonts in Next.js
// app/layout.tsx
import { Inter, Fira_Code } from 'next/font/google'
const inter = Inter({
subsets: ['latin'],
variable: '--font-inter',
display: 'swap',
})
const firaCode = Fira_Code({
subsets: ['latin'],
variable: '--font-fira-code',
display: 'swap',
})
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en" className={`${inter.variable} ${firaCode.variable}`}>
<body className="font-sans antialiased">{children}</body>
</html>
)
}
Component Patterns
Compound Components
Group related UI into a single composable API.
// components/ui/Card/index.tsx
interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
variant?: 'default' | 'elevated' | 'outlined'
}
function Card({ variant = 'default', className, ...props }: CardProps) {
const variants = {
default: 'bg-white border border-gray-100 shadow-sm',
elevated: 'bg-white shadow-lg',
outlined: 'bg-transparent border-2 border-gray-200',
}
return (
<div
className={`rounded-2xl p-6 ${variants[variant]} ${className ?? ''}`}
{...props}
/>
)
}
function CardHeader({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
return <div className={`mb-4 ${className ?? ''}`} {...props} />
}
function CardTitle({ className, ...props }: React.HTMLAttributes<HTMLHeadingElement>) {
return <h3 className={`text-lg font-semibold text-gray-900 ${className ?? ''}`} {...props} />
}
function CardContent({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
return <div className={`text-gray-600 ${className ?? ''}`} {...props} />
}
function CardFooter({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
return <div className={`mt-4 pt-4 border-t border-gray-100 ${className ?? ''}`} {...props} />
}
Card.Header = CardHeader
Card.Title = CardTitle
Card.Content = CardContent
Card.Footer = CardFooter
export { Card }
Button Variants with CVA
// components/ui/Button.tsx
import { cva, type VariantProps } from 'class-variance-authority'
import { forwardRef } from 'react'
const buttonVariants = cva(
// Base styles
'inline-flex items-center justify-center rounded-lg font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50',
{
variants: {
variant: {
primary: 'bg-blue-600 text-white hover:bg-blue-700 focus-visible:ring-blue-500',
secondary: 'bg-gray-100 text-gray-900 hover:bg-gray-200 focus-visible:ring-gray-500',
ghost: 'hover:bg-gray-100 text-gray-700 focus-visible:ring-gray-500',
danger: 'bg-red-600 text-white hover:bg-red-700 focus-visible:ring-red-500',
outline: 'border border-gray-300 bg-transparent hover:bg-gray-50 text-gray-700',
},
size: {
阅读完整来源 ↗