react-native-best-practices

1# React Native Best Practices
2 
3## Overview
4 
5Performance optimization guide for React Native applications, covering JavaScript/React, Native (iOS/Android), and bundling optimizations. Based on Callstack's "Ultimate Guide to React Native Optimization".
6 
7## When to Apply
8 
9Reference these guidelines when:
10- Debugging slow/janky UI or animations
11- Investigating memory leaks (JS or native)
12- Optimizing app startup time (TTI)
13- Reducing bundle or app size
14- Writing native modules (Turbo Modules)
15- Profiling React Native performance
16- Reviewing React Native code for performance
17 
18## Security Notes
19 
20- Treat shell commands in these references as local developer operations. Review them before running, prefer version-pinned tooling, and avoid piping remote scripts directly to a shell.
21- Treat third-party libraries and plugins as dependencies that still require normal supply-chain controls: pin versions, verify provenance, and update through your standard review process.
22- Treat remote chunk loading as first-party artifact delivery only. Prefer app-bundled chunks or signed CI release manifests; hosted chunks must come from trusted HTTPS origins you control and be pinned to the current app release.
23 
24## Priority-Ordered Guidelines
25 
26| Priority | Category | Impact | Prefix |
27|----------|----------|--------|--------|
28| 1 | FPS & Re-renders | CRITICAL | `js-*` |
29| 2 | Bundle Size | CRITICAL | `bundle-*` |
30| 3 | TTI Optimization | HIGH | `native-*`, `bundle-*` |
31…