react-patterns
Provides comprehensive React 19 patterns for Server Components, Server Actions, useOptimistic, useActionState, useTransition, concurrent features, Suspense boundaries, and TypeScript integration. Generates executable code patterns, validates security for public endpoints, and optimizes performance w
By giuseppe-trisciuoglio · 3,913 installs
npx skills add giuseppe-trisciuoglio/developer-kit --skill react-patterns
Source repository · Upstream listing
React 19 Development Patterns
Overview
React 19 patterns for Next.js App Router, Server Actions, optimistic UI, and concurrent features. See Quick Reference for API summary and Examples for copy paste patterns.
When to Use
Building React 19 applications with Next.js App Router
Implementing optimistic UI with useOptimistic or useTransition
Creating Server Actions with form validation
Migrating from class components to hooks
Optimizing concurrent rendering with React Compiler
Managing complex state with useReducer or custom hooks
Wrapping async operations in Suspense boundaries
Quick Reference
Pattern Hook / API Use Case
Local state useState Simple component state
Complex state useReducer Multi action state machines
Side effects useEffect Subscriptions, data fetching
Shared state useContext / createContext Cross component data
DOM access useRef Focus, measurements, timers
Performance useMemo / useCallback Expensive computations
Non urgent updates useTransition Search/filter on large lists
Defer expensive UI useDeferredValue Stale while updating
Read resources use() (React 19) Promises and context in render
Optimistic UI useOptimistic (React 19) Instant feedback on mutations
Form status useFormStatus (React 19) Pending state in child components
Form state useActionState (React 19) Server action results
Auto memoization React Compiler Eliminates manual memo/callback
Instructions
1. Identify Component Type : Determine if Server Component or Client Component is needed
2. Select Hooks : Use appropriate hooks for state management and side effects
3. Type Props : Define TypeScript interfaces for all component props
4. Handle Async : Wrap data fetching components in Suspense boundaries
5. Optimize : Use React Compiler or manual memoization for expensive renders
6. Handle Errors : Add ErrorBoundary for graceful error handling
7. Validate Server Actions : Define Zod/schema validation, then test:
Submit invalid inputs → verify rejection
Submit valid inputs → verify success
Examples
Server Component with Client Interaction
useOptimistic for Instant Feedback
Server Action with Form
Custom Hook
useTransition for Non Urgent Updates
Best Practices
Server vs Client Decision
Start with Server Component (no directive needed)
Add 'use client' only for: hooks, browser APIs, event handlers
State Management
Keep state minimal — compute derived values during render, not in effects
Use useReducer for state with multiple related actions
Lift state up to the nearest common ancestor
Effects
Use effects only for external system synchronization
Always specify correct dependency arrays
Return cleanup functions for subscriptions and timers
Never mutate state directly — always create new references
Performance
With React Compiler: avoid manual useMemo , useCallback , memo
Without React Compiler: use useMemo for expensive computations, useCallback for stable callbacks
Use useTransition for low priority state updates
Use stable IDs as list keys, not array indices
React 19 Specifics
Wrap use(promise) components in Suspense boundaries
Use useActionState for form server action integration
Validate Server Action inputs — they are public endpoints
Pass serializable data from Server to Client Components
Constraints and Warnings
Server Components : Cannot use hooks, event handlers, or browser APIs
use() Hook : Can only be called during render, not in callbacks or effects
Server Actions : Must include 'use server' directive; always validate inputs
State Mutations : Never mutate state directly — always create new references
Effect Dependencies : Include all dependencies in useEffect dependency arrays
Memory Leaks : Always clean up subscriptions and event listeners in useEffect return
References
Consult these files for detailed patterns:
[references/hooks patterns.md](references/hooks patterns.md) — useState, useEffect, useRef, useReducer, custom hooks, common pitfalls
[references/component patterns.md](references/component patterns.md) — Props, composition, lifting state, context, compound components, error boundaries
[references/react19 features.md](references/react19 features.md) — use(), useOptimistic, useFormStatus, useActionState, Server Actions, Server Components, migration guide
[references/performance patterns.md](references/performance patterns.md) — React Compiler setup, useMemo, useCallback, useTransition, useDeferredValue, lazy loading
[references/typescript patterns.md](references/typescript patterns.md) — Typed props, generic components, event handlers, discriminated unions, context typing
[references/learn.md](references/learn.md) — Progressive learning guide from basics to advanced React 19
[references/reference.md](references/reference.md) — Complete API reference for all React hooks and component APIs