Frontend Development Patterns
Оптимизируйте свой фронтенд-воркфлоу с Claude Code. Получите экспертные паттерны React, хуки управления состоянием и оптимизацию производительности для приложений Next.js.
Этот навык предоставляет Клоду обширную библиотеку современных паттернов фронтенд-разработки, специально адаптированных для экосистем React и Next.js. Он даёт специализированные рекомендации по композиции компонентов, сложному управлению состоянием и разработке пользовательских хуков, гарантируя, что пользовательские интерфейсы будут масштабируемыми и поддерживаемыми. Используя этот навык, разработчики могут автоматизировать реализацию продвинутых UI-паттернов, таких как Compound Components, Render Props и архитектура Context + Reducer, а также внедрять лучшие практики производительности, такие как виртуализация и ленивая загрузка.
Ключевые особенности
Варианты использования
| name | frontend-patterns | ||
|---|---|---|---|
| description | Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices. | ||
| metadata |
|
Modern frontend patterns for React, Next.js, and performant user interfaces.
- Building React components (composition, props, rendering)
- Managing state (useState, useReducer, Zustand, Context)
- Implementing data fetching (SWR, React Query, server components)
- Optimizing performance (memoization, virtualization, code splitting)
- Working with forms (validation, controlled inputs, Zod schemas)
- Handling client-side routing and navigation
- Building accessible, responsive UI patterns
// PASS: GOOD: Component composition
interface CardProps {
children: React.ReactNode
variant?: 'default' | 'outlined'
}
export function Card({ children, variant = 'default' }: CardProps) {
return <div className={`card card-${variant}`}>{children}</div>
}
export function CardHeader({ children }: { children: React.ReactNode }) {
return <div className="card-header">{children}</div>
}
export function CardBody({ children }: { children: React.ReactNode }) {
return <div className="card-body">{children}</div>
}
// Usage
<Card>
<CardHeader>Title</CardHeader>
<CardBody>Content</CardBody>
</Card>interface TabsContextValue {
activeTab: string
setActiveTab: (tab: string) => void
}
const TabsContext = createContext<TabsContextValue | undefined>(undefined)
export function Tabs({ children, defaultTab }: {
children: React.ReactNode
defaultTab: string
}) {
const [activeTab, setActiveTab] = useState(defaultTab)
return (
<TabsContext.Provider value={{ activeTab, setActiveTab }}>
{children}
</TabsContext.Provider>
)
}
export function TabList({ children }: { children: React.ReactNode }) {
return <div className="tab-list">{children}</div>
}
export function Tab({ id, children }: { id: string, children: React.ReactNode }) {
const context = useContext(TabsContext)
if (!context) throw new Error('Tab must be used within Tabs')
return (
<button
className={context.activeTab === id ? 'active' : ''}
onClick={() => context.setActiveTab(id)}
>
{children}
</button>
)
}
// Usage
<Tabs defaultTab="overview">
<TabList>
<Tab id="overview">Overview</Tab>
<Tab id="details">Details</Tab>
</TabList>
</Tabs>interface DataLoaderProps<T> {
url: string
children: (data: T | null, loading: boolean, error: Error | null) => React.ReactNode
}
export function DataLoader<T>({ url, children }: DataLoaderProps<T>) {
const [data, setData] = useState<T | null>(null)
const [loading, setLoading] = useState(true)
const [error, setError] = useState<Error | null>(null)
useEffect(() => {
fetch(url)
.then(res => res.json())
.then(setData)
.catch(setError)
.finally(() => setLoading(false))
}, [url])
return <>{children(data, loading, error)}</>
}
// Usage
<DataLoader<Market[]> url="/api/markets">
{(markets, loading, error) => {
if (loading) return <Spinner />
if (error) return <Error error={error} />
return <MarketList markets={markets!} />
}}
</DataLoader>export function useToggle(initialValue = false): [boolean, () => void] {
const [value, setValue] = useState(initialValue)
const toggle = useCallback(() => {
setValue(v => !v)
}, [])
return [value, toggle]
}
// Usage
const [isOpen, toggleOpen] = useToggle()interface UseQueryOptions<T> {
onSuccess?: (data: T) => void
onError?: (error: Error) => void
enabled?: boolean
}
export function useQuery<T>(
key: string,
fetcher: () => Promise<T>,
options?: UseQueryOptions<T>
) {
const [data, setData] = useState<T | null>(null)
const [error, setError] = useState<Error | null>(null)
const [loading, setLoading] = useState(false)
const refetch = useCallback(async () => {
setLoading(true)
setError(null)
try {
const result = await fetcher()
setData(result)
options?.onSuccess?.(result)
} catch (err) {
const error = err as Error
setError(error)
options?.onError?.(error)
} finally {
setLoading(false)
}
}, [fetcher, options])
useEffect(() => {
if (options?.enabled !== false) {
refetch()
}
}, [key, refetch, options?.enabled])
return { data, error, loading, refetch }
}
// Usage
const { data: markets, loading, error, refetch } = useQuery(
'markets',
() => fetch('/api/markets').then(r => r.json()),
{
onSuccess: data => console.log('Fetched', data.length, 'markets'),
onError: err => console.error('Failed:', err)
}
)export function useDebounce<T>(value: T, delay: number): T {
const [debouncedValue, setDebouncedValue] = useState<T>(value)
useEffect(() => {
const handler = setTimeout(() => {
setDebouncedValue(value)
}, delay)
return () => clearTimeout(handler)
}, [value, delay])
return debouncedValue
}
// Usage
const [searchQuery, setSearchQuery] = useState('')
const debouncedQuery = useDebounce(searchQuery, 500)
useEffect(() => {
if (debouncedQuery) {
performSearch(debouncedQuery)
}
}, [debouncedQuery])interface State {
markets: Market[]
selectedMarket: Market | null
loading: boolean
}
type Action =
| { type: 'SET_MARKETS'; payload: Market[] }
| { type: 'SELECT_MARKET'; payload: Market }
| { type: 'SET_LOADING'; payload: boolean }
function reducer(state: State, action: Action): State {
switch (action.type) {
case 'SET_MARKETS':
return { ...state, markets: action.payload }
case 'SELECT_MARKET':
return { ...state, selectedMarket: action.payload }
case 'SET_LOADING':
return { ...state, loading: action.payload }
default:
return state
}
}
const MarketContext = createContext<{
state: State
dispatch: Dispatch<Action>
} | undefined>(undefined)
export function MarketProvider({ children }: { children: React.ReactNode }) {
const [state, dispatch] = useReducer(reducer, {
markets: [],
selectedMarket: null,
loading: false
})
return (
<MarketContext.Provider value={{ state, dispatch }}>
{children}
</MarketContext.Provider>
)
}
export function useMarkets() {
const context = useContext(MarketContext)
if (!context) throw new Error('useMarkets must be used within MarketProvider')
return context
}// PASS: useMemo for expensive computations
const sortedMarkets = useMemo(() => {
return markets.sort((a, b) => b.volume - a.volume)
}, [markets])
// PASS: useCallback for functions passed to children
const handleSearch = useCallback((query: string) => {
setSearchQuery(query)
}, [])
// PASS: React.memo for pure components
export const MarketCard = React.memo<MarketCardProps>(({ market }) => {
return (
<div className="market-card">
<h3>{market.name}</h3>
<p>{market.description}</p>
</div>
)
})import { lazy, Suspense } from 'react'
// PASS: Lazy load heavy components
const HeavyChart = lazy(() => import('./HeavyChart'))
const ThreeJsBackground = lazy(() => import('./ThreeJsBackground'))
export function Dashboard() {
return (
<div>
<Suspense fallback={<ChartSkeleton />}>
<HeavyChart data={data} />
</Suspense>
<Suspense fallback={null}>
<ThreeJsBackground />
</Suspense>
</div>
)
}import { useVirtualizer } from '@tanstack/react-virtual'
export function VirtualMarketList({ markets }: { markets: Market[] }) {
const parentRef = useRef<HTMLDivElement>(null)
const virtualizer = useVirtualizer({
count: markets.length,
getScrollElement: () => parentRef.current,
estimateSize: () => 100, // Estimated row height
overscan: 5 // Extra items to render
})
return (
<div ref={parentRef} style={{ height: '600px', overflow: 'auto' }}>
<div
style={{
height: `${virtualizer.getTotalSize()}px`,
position: 'relative'
}}
>
{virtualizer.getVirtualItems().map(virtualRow => (
<div
key={virtualRow.index}
style={{
position: 'absolute',
top: 0,
left: 0,
width: '100%',
height: `${virtualRow.size}px`,
transform: `translateY(${virtualRow.start}px)`
}}
>
<MarketCard market={markets[virtualRow.index]} />
</div>
))}
</div>
</div>
)
}interface FormData {
name: string
description: string
endDate: string
}
interface FormErrors {
name?: string
description?: string
endDate?: string
}
export function CreateMarketForm() {
const [formData, setFormData] = useState<FormData>({
name: '',
description: '',
endDate: ''
})
const [errors, setErrors] = useState<FormErrors>({})
const validate = (): boolean => {
const newErrors: FormErrors = {}
if (!formData.name.trim()) {
newErrors.name = 'Name is required'
} else if (formData.name.length > 200) {
newErrors.name = 'Name must be under 200 characters'
}
if (!formData.description.trim()) {
newErrors.description = 'Description is required'
}
if (!formData.endDate) {
newErrors.endDate = 'End date is required'
}
setErrors(newErrors)
return Object.keys(newErrors).length === 0
}
const handleSubmit = async (e: React.FormEvent) => {
e.preventDefault()
if (!validate()) return
try {
await createMarket(formData)
// Success handling
} catch (error) {
// Error handling
}
}
return (
<form onSubmit={handleSubmit}>
<input
value={formData.name}
onChange={e => setFormData(prev => ({ ...prev, name: e.target.value }))}
placeholder="Market name"
/>
{errors.name && <span className="error">{errors.name}</span>}
{/* Other fields */}
<button type="submit">Create Market</button>
</form>
)
}interface ErrorBoundaryState {
hasError: boolean
error: Error | null
}
export class ErrorBoundary extends React.Component<
{ children: React.ReactNode },
ErrorBoundaryState
> {
state: ErrorBoundaryState = {
hasError: false,
error: null
}
static getDerivedStateFromError(error: Error): ErrorBoundaryState {
return { hasError: true, error }
}
componentDidCatch(error: Error, errorInfo: React.ErrorInfo) {
console.error('Error boundary caught:', error, errorInfo)
}
render() {
if (this.state.hasError) {
return (
<div className="error-fallback">
<h2>Something went wrong</h2>
<p>{this.state.error?.message}</p>
<button onClick={() => this.setState({ hasError: false })}>
Try again
</button>
</div>
)
}
return this.props.children
}
}
// Usage
<ErrorBoundary>
<App />
</ErrorBoundary>import { motion, AnimatePresence } from 'framer-motion'
// PASS: List animations
export function AnimatedMarketList({ markets }: { markets: Market[] }) {
return (
<AnimatePresence>
{markets.map(market => (
<motion.div
key={market.id}
initial={{ opacity: 0, y: 20 }}
animate={{ opacity: 1, y: 0 }}
exit={{ opacity: 0, y: -20 }}
transition={{ duration: 0.3 }}
>
<MarketCard market={market} />
</motion.div>
))}
</AnimatePresence>
)
}
// PASS: Modal animations
export function Modal({ isOpen, onClose, children }: ModalProps) {
return (
<AnimatePresence>
{isOpen && (
<>
<motion.div
className="modal-overlay"
initial={{ opacity: 0 }}
animate={{ opacity: 1 }}
exit={{ opacity: 0 }}
onClick={onClose}
/>
<motion.div
className="modal-content"
initial={{ opacity: 0, scale: 0.9, y: 20 }}
animate={{ opacity: 1, scale: 1, y: 0 }}
exit={{ opacity: 0, scale: 0.9, y: 20 }}
>
{children}
</motion.div>
</>
)}
</AnimatePresence>
)
}export function Dropdown({ options, onSelect }: DropdownProps) {
const [isOpen, setIsOpen] = useState(false)
const [activeIndex, setActiveIndex] = useState(0)
const handleKeyDown = (e: React.KeyboardEvent) => {
switch (e.key) {
case 'ArrowDown':
e.preventDefault()
setActiveIndex(i => Math.min(i + 1, options.length - 1))
break
case 'ArrowUp':
e.preventDefault()
setActiveIndex(i => Math.max(i - 1, 0))
break
case 'Enter':
e.preventDefault()
onSelect(options[activeIndex])
setIsOpen(false)
break
case 'Escape':
setIsOpen(false)
break
}
}
return (
<div
role="combobox"
aria-expanded={isOpen}
aria-haspopup="listbox"
onKeyDown={handleKeyDown}
>
{/* Dropdown implementation */}
</div>
)
}export function Modal({ isOpen, onClose, children }: ModalProps) {
const modalRef = useRef<HTMLDivElement>(null)
const previousFocusRef = useRef<HTMLElement | null>(null)
useEffect(() => {
if (isOpen) {
// Save currently focused element
previousFocusRef.current = document.activeElement as HTMLElement
// Focus modal
modalRef.current?.focus()
} else {
// Restore focus when closing
previousFocusRef.current?.focus()
}
}, [isOpen])
return isOpen ? (
<div
ref={modalRef}
role="dialog"
aria-modal="true"
tabIndex={-1}
onKeyDown={e => e.key === 'Escape' && onClose()}
>
{children}
</div>
) : null
}Remember: Modern frontend patterns enable maintainable, performant user interfaces. Choose patterns that fit your project complexity.
🧩 Что это
Набор проверенных frontend-паттернов и best practices для разработки на React, Next.js и TypeScript. Этот skill — не библиотека и не фреймворк, а референс-справочник по архитектуре компонентов, управлению состоянием, оптимизации производительности, обработке форм, анимации и доступности (a11y). Подходит для проектов любой сложности — от простых дашбордов до сложных мультистраничных приложений.
⚙️ Как работает
🗂️ Компонентные паттерны
Композиция вместо наследования — базовый принцип React. Skill демонстрирует построение UI из мелких, переиспользуемых блоков: Card, CardHeader, CardBody. Это даёт гибкость: можно собирать разметку как конструктор.
Compound Components (составные компоненты) — когда несколько компонентов работают как одно целое через общий контекст. Например, Tabs — TabList — Tab: родитель управляет активной вкладкой, а дети подхватывают это через TabsContext. Иначе говоря, создаётся невидимая «шина» между элементами без передачи пропсов через всю иерархию.
Render Props — паттерн, при котором компонент получает функцию children и вызывает её с данными. В примере DataLoader сам выполняет fetch и возвращает { data, loading, error } наружу, а вызывающий код решает, что рендерить: спиннер, ошибку или список. Удобно для универсальных загрузчиков данных.
🪝 Кастомные хуки
Три практичных хука-примера:
useToggle— простой переключатель (true/false) с useCallback. Подходит для модалок, дропдаунов, любых флагов.useQuery— асинхронная загрузка с состоянием{ data, error, loading, refetch }. Хук принимает ключ (key), функцию-загрузчик и опциональные колбэки (onSuccess,onError,enabled). Позволяет повторно получить данные по вызовуrefetch.useDebounce— задерживает обновление значения на заданное количество миллисекунд. Типичный сценарий: не отправлять поисковый запрос при каждом нажатии клавиши, а ждать 300–500 мс после последнего изменения.
🧠 Управление состоянием: Context + Reducer
Для глобального состояния, которое требует более сложной логики, предлагается паттерн useReducer + Context. В MarketProvider объявляется reducer с действиями SET_MARKETS, SELECT_MARKET, SET_LOADING. Хук useMarkets предоставляет доступ к состоянию и dispatch. Это среднее между raw setState и полноценной библиотекой вроде Zustand или Redux — достаточно для большинства приложений уровня medium.
⚡ Оптимизация производительности
Skill напоминает о трёх ключевых техниках:
Мемоизация — useMemo для тяжёлых вычислений (сортировка списка), useCallback для стабильных функций-колбэков, React.memo для чистых компонентов, чтобы избежать лишних ререндеров.
Code Splitting + Lazy Loading — через React.lazy + Suspense. Тяжёлый график или 3D-фон загружаются только когда действительно нужны. В качестве fallback можно показать скелетон или ничего (null).
Виртуализация списков — на примере @tanstack/react-virtual. Для длинных списков рендерятся только видимые строки плюс overscan. Указывается getScrollElement, estimateSize (100px в примере). Это резко снижает нагрузку на DOM.
📋 Формы и валидация
Пример CreateMarketForm — контролируемая форма с ручной валидацией. Состояние формы (formData) и ошибок (errors) разделены. В handleSubmit вызывается validate(), которая проверяет обязательные поля и длину имени. Если ошибок нет — выполняется запрос; если есть — показывается сообщение рядом с полем. Skill рекомендует дополнять этот паттерн библиотекой Zod для схем валидации.
🛡️ Error Boundary (граница ошибок)
Классовый компонент-обёртка, который ловит ошибки в дочернем дереве (не в самом себе) и показывает запасной UI. Включает кнопку «Try again», которая сбрасывает hasError: false. Полезно для виджетов — падение одного не должно убивать всё приложение.
🎬 Анимация с Framer Motion
Два типовых сценария:
- Список с анимацией появления/удаления —
AnimatePresence+motion.divсinitial,animate,exit. Элементы плавно въезжают (opacity + y) и уезжают. - Модальное окно — затемнение (overlay) появляется через opacity, контент — с масштабированием и смещением. При закрытии всё уходит обратно.
♿ Доступность (Accessibility)
Клавиатурная навигация — для дропдауна (role="combobox") обрабатываются ArrowDown, ArrowUp, Enter, Escape. Активный элемент подсвечивается через activeIndex.
Фокус-менеджмент — при открытии модалки фокус принудительно перемещается на неё (modalRef.current?.focus()), при закрытии — возвращается на элемент, который был в фокусе до открытия (previousFocusRef.current?.focus()). Это base requirement для соответствия WCAG.
🎯 Когда использовать
Этот skill стоит открыть, когда вы:
- Проектируете компонентную архитектуру — чтобы решить, как разбивать UI и как связать части (composition vs compound components vs render props).
- Настраиваете локальное или глобальное состояние — хотите понять, хватит ли
useReducer+ Context или пора подключать внешнюю библиотеку. - Оптимизируете производительность списков, тяжёлых вычислений или загрузки кода — увидеть приёмы memo, lazy, virtualizer в одном месте.
- Строите сложную форму с валидацией или работаете над доступностью (особенно фокус-менеджмент и навигация с клавиатуры).
- Добавляете анимации входа/выхода элементов.
⚠️ Важно знать
- Паттерны — не догма. Если проект простой, композиция и
useStateрешают 90 % задач. Не усложняйте код без необходимости. - Context + Reducer не заменяет полноценный стейт-менеджмент для высоконагруженных приложений с частыми обновлениями (например, real-time трейдинг). Для таких случаев рассмотрите Zustand или Jotai.
- Error Boundary ловит ошибки только в дочернем дереве. Чтобы поймать ошибку в самом Error Boundary, нужна другая обёртка.
- Виртуализация имеет смысл для списков от нескольких сотен элементов. Для 10–20 пунктов она adds overhead без реального профита.
- Framer Motion — внешняя зависимость. Если анимаций мало, можно обойтись CSS transitions или react-spring. Выбирайте под объём анимаций.
- TypeScript — все примеры используют типизацию. Это делает код самодокументируемым и упрощает рефакторинг. Без TS часть паттернов теряет в прозрачности.
Совместимо ли это с Next.js и Server Components?
Да, паттерны разработаны для современных веб-сред, включая поддержку Next.js, серверной выборки данных и клиентской интерактивности.
Поддерживает ли оптимизацию производительности для больших наборов данных?
Да, навык включает конкретные паттерны для мемоизации и виртуализации списков с помощью TanStack Virtual для поддержания отзывчивости интерфейсов.
Как этот навык улучшает мою разработку на React?
Он предоставляет Claude конкретные архитектурные паттерны, такие как Compound Components и Render Props, гарантируя, что ваш сгенерированный код будет чистым, модульным и соответствует отраслевым стандартам.
Какие стратегии управления состоянием включены?
Включены паттерны для локального состояния, паттерн Context + Reducer для сложной логики и реализации пользовательских хуков для управления побочными эффектами.
Могу ли я использовать это для валидации форм и обработки ввода?
Безусловно. Он охватывает паттерны контролируемых форм и предоставляет рекомендации по интеграции схем валидации для надежной обработки пользовательского ввода.
Синхронизируйте навыки с Claude Cowork, Claude Code, Codex и другими.
Установка одной командой.
npx skillfish add affaan-m/everything-claude-code frontend-patternsИсточник: https://mcpmarket.com/tools/skills/frontend-development-patterns-1777849903941
Комментарии
Комментариев пока нет. Будьте первым.