React Component Patterns
Priority: P0 (CRITICAL)
Standards for building scalable, maintainable React components.
Implementation Guidelines
- •Function Components: Only hooks. No classes.
- •Composition: Use
childrenprop. Avoid inheritance. - •Props: Explicit TS interfaces. Destructure in params.
- •Boolean Props: Shorthand
<Cmp isVisible />vsisVisible={true}. - •Imports: Group:
Built-in->External->Internal->Styles. - •Error Boundaries: Wrap app/features with
react-error-boundary. - •Size: Small (< 250 lines). One component per file.
- •Naming:
PascalCasecomponents.use*hooks. - •Exports: Named exports only.
- •Conditionals: Ternary (
Cond ? <A/> : <B/>) over&&for rendering consistency. - •Hoisting: Extract static JSX/Objects outside component to prevent recreation.
Anti-Patterns
- •No Classes: Use hooks.
- •No Prop Drilling: Use Context/Zustand.
- •No Nested Definitions: Define components at top level.
- •No Index Keys: Use stable IDs.
- •No Inline Handlers: Define before return.
Reference & Examples
See references/patterns.md for Composition, Compound Components, and Render Props examples.
Related Topics
hooks | state-management | performance