1# Sections
2 
3This file defines all sections, their ordering, impact levels, and descriptions.
4The section ID (in parentheses) is the filename prefix used to group rules.
5 
6---
7 
8## 1. Core Rendering (rendering)
9 
10**Impact:** CRITICAL  
11**Description:** Fundamental React Native rendering rules. Violations cause
12runtime crashes or broken UI.
13 
14## 2. List Performance (list-performance)
15 
16**Impact:** HIGH  
17**Description:** Optimizing virtualized lists (FlatList, LegendList, FlashList)
18for smooth scrolling and fast updates.
19 
20## 3. Animation (animation)
21 
22**Impact:** HIGH  
23**Description:** GPU-accelerated animations, Reanimated patterns, and avoiding
24render thrashing during gestures.
25 
26## 4. Scroll Performance (scroll)
27 
28**Impact:** HIGH  
29**Description:** Tracking scroll position without causing render thrashing.
30 
31## 5. Navigation (navigation)
32 
33**Impact:** HIGH  
34**Description:** Using native navigators for stack and tab navigation instead of
35JS-based alternatives.
36 
37## 6. React State (react-state)
38 
39**Impact:** MEDIUM  
40**Description:** Patterns for managing React state to avoid stale closures and
41unnecessary re-renders.
42 
43## 7. State Architecture (state)
44 
45**Impact:** MEDIUM  
46**Description:** Ground truth principles for state variables and derived values.
47 
48## 8. React Compiler (react-compiler)
49 
50**Impact:** MEDIUM  
51**Description:** Compatibility patterns for React Compiler with React Native and
52Reanimated.
53 
54## 9. User Interface (ui)
55 
56**Impact:** MEDIUM  
57**Description:** Native UI patterns for images, menus, modals, styling, and
58platform-consistent interfaces.
59 
60## 10. Design System (design-system)
61 
62**Impact:** MEDIUM  
63**Description:** Architecture patterns for building maintainable component
64libraries.
65 
66## 11. Monorepo (monorepo)
67 
68**Impact:** LOW  
69**Description:** Dependency management and native module configuration in
70monorepos.
71 
72## 12. Third-Party Dependencies (imports)
73 
74**Impact:** LOW  
75**Description:** Wrapping and re-exporting third-party dependencies for
76maintainability.
77 
78## 13. JavaScript (js)
79 
80**Impact:** LOW  
81**Description:** Micro-optimizations like hoisting expensive object creation.
82 
83## 14. Fonts (fonts)
84 
85**Impact:** LOW  
86**Description:** Native font loading for improved performance.
87