React Clean Architecture

Principles and rules for building scalable, maintainable React codebases in enterprise systems.

Full reference: See references/architecture-guidelines.md

When to Use

• Designing or reviewing component hierarchies
• Organizing directories for a new feature or page
• Decomposing a large component (the 200-line rule)
• Choosing between local, global, and server state
• Applying composition patterns (slots, compound components, children)
• Creating custom hooks to extract logic from components
• Enforcing colocation and Feature-Sliced Design boundaries
• Reviewing naming conventions and import strategies
• Setting up testing strategy for React features

Constitutional Rules