Cursor rule

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