react-19

React 19.2 Core Features

Agent Workflow (MANDATORY)

Before ANY implementation, use TeamCreate to spawn 3 agents:

1. fuse-ai-pilot:explore-codebase - Analyze existing React patterns and component structure
2. fuse-ai-pilot:research-expert - Verify latest React 19.2 docs via Context7/Exa
3. mcp__context7__query-docs - Check use(), useOptimistic, useActionState, Activity patterns

After implementation, run fuse-ai-pilot:sniper for validation.

---

What's New in React 19.2

New Hooks

Hook	Purpose	Guide
use()	Read promises/context in render	references/new-hooks.md
useOptimistic	Optimistic UI updates	references/new-hooks.md
useActionState	Form action state management	references/new-hooks.md
useFormStatus	Form pending state (child components)	references/new-hooks.md
useEffectEvent	Non-reactive callbacks in effects	references/new-hooks.md

→ See references/new-hooks.md for detailed usage

---

Classic Hooks (React 18+)

State Hooks

Hook	Purpose	Guide
useState	Local component state	references/use-state.md

→ For global state, see react-state skill

Effect Hooks

Hook	Purpose	Guide
useEffect	Side effects after paint	references/use-effect.md
useLayoutEffect	Sync DOM before paint	references/use-layout-effect.md

Ref Hooks

Hook	Purpose	Guide
useRef	DOM access, mutable values	references/use-ref.md
useImperativeHandle	Customize ref API	references/use-imperative-handle.md

Performance Hooks (Rare with Compiler)

Hook	Purpose	Guide
useMemo	Memoize expensive values	references/use-memo.md
useCallback	Memoize functions	references/use-callback.md

→ React Compiler handles most memoization automatically

Other Hooks

Hook	Purpose	Guide
useId	Unique IDs for accessibility	references/use-id.md
useSyncExternalStore	External store subscription	references/use-sync-external-store.md

Custom Hooks

→ See references/custom-hooks-patterns.md for patterns → See references/templates/custom-hooks.md for implementations

---

Activity Component (19.2)

Hide/show components while preserving state:

<Activity mode={isActive ? 'visible' : 'hidden'}>
  <TabContent />
</Activity>

→ See references/activity-component.md for patterns

React Compiler (19.1+)

Automatic memoization - useMemo/useCallback mostly obsolete:

• Build-time optimization
• No more manual memoization in most cases
• 2.5× faster interactions reported

→ See references/react-compiler.md for details

---

Quick Reference

use() Hook

// Read promise in render (with Suspense)
const data = use(dataPromise)

// Read context conditionally (unique to use())
if (condition) {
  const theme = use(ThemeContext)
}

→ See references/templates/use-promise.md

useOptimistic

const [optimisticValue, setOptimistic] = useOptimistic(actualValue)
// Update UI immediately, server updates later

→ See references/templates/optimistic-update.md

useActionState

const [state, action, isPending] = useActionState(asyncFn, initialState)

→ See references/templates/action-form.md

useEffectEvent (19.2)

const onEvent = useEffectEvent(() => {
  // Always has fresh props/state, doesn't trigger re-run
})

useEffect(() => {
  connection.on('event', onEvent)
}, []) // No need to add onEvent to deps

→ See references/new-hooks.md

---

Breaking Changes from 18

Change	Migration
ref is a prop	Remove forwardRef wrapper
Context is provider	Use <Context value={}> directly
useFormStatus	Import from react-dom

→ See references/migration-18-19.md

---

Best Practices

1. Data fetching: Use use() + Suspense, NOT useEffect
2. Forms: Use Actions + useActionState
3. Optimistic UI: Use useOptimistic for instant feedback
4. Tabs/Modals: Use <Activity> to preserve state
5. Effect events: Use useEffectEvent for non-reactive callbacks
6. Memoization: Let React Compiler handle it

---

Templates

React 19 Patterns

Template	Use Case
templates/action-form.md	Form with useActionState
templates/optimistic-update.md	useOptimistic pattern
templates/activity-tabs.md	Activity component tabs
templates/use-promise.md	use() with promises

Classic Hooks Patterns

Template	Use Case
templates/state-patterns.md	useState patterns
templates/effect-patterns.md	useEffect patterns
templates/ref-patterns.md	useRef patterns
templates/custom-hooks.md	Custom hooks implementations
templates/external-store.md	useSyncExternalStore patterns

Performance Patterns

Template	Use Case
templates/virtual-list.md	TanStack Virtual for long lists
templates/lazy-components.md	Code splitting and lazy loading
templates/profiling-devtools.md	React DevTools Profiler

---

Performance

Virtualization

Render only visible items for large lists (100+ items). → See references/virtualization.md

Lazy Loading

Code split routes and heavy components for smaller bundles. → See references/lazy-loading.md

Profiling

Measure render performance with DevTools Profiler. → See references/profiling.md

Note: With React Compiler (19.1+), manual memo/useMemo/useCallback optimizations are mostly obsolete. Profile first to verify if optimization is needed.

---

Forbidden (Outdated Patterns)

• ❌ useEffect for data fetching → use use() + Suspense
• ❌ forwardRef → use ref as prop
• ❌ <Context.Provider> → use <Context value={}>
• ❌ Manual useMemo/useCallback everywhere → let Compiler handle it
• ❌ Conditional rendering for state preservation → use <Activity>