mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
Every page now loads /webmcp.js, scripts/webmcp.ts with its types stripped (npm run webmcp). Where the browser has document.modelContext it registers two read-only tools: search_skills over the published skills index, and get_skill, which returns a skill's markdown checked against the index digest. The markdown alternate link moves from build.py to site.py, so CI holds every page to it. The API catalog gains the site itself (llms.txt and the skills index) and hanzo.ai/agents; the live discovery check now fetches every catalog link. tests/site.mjs drives the tools through a recording modelContext, and checks a browser without one loads clean.
695 lines
30 KiB
HTML
695 lines
30 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>mobile-react-native-performance</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/mobile-react-native-performance">
|
|
<link rel="alternate" type="text/markdown" href="/mobile-react-native-performance.md">
|
|
<script type="module" src="/webmcp.js"></script>
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/mobile-react-native-performance.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>mobile-react-native-performance</h1><p class="lede">App animations are dropping frames (not 60fps)</p><h1>React Native Performance</h1>
|
|
<p><strong>Scope</strong>: React Native performance optimization, iOS-specific optimizations, profiling, memory management <strong>Lines</strong>: ~360 <strong>Last Updated</strong>: 2025-10-18</p>
|
|
<h2>When to Use This Skill</h2>
|
|
<p>Activate this skill when:</p>
|
|
<ul><li>App animations are dropping frames (not 60fps)</li><li>Experiencing slow list scrolling or lag</li><li>High memory usage or crashes on iOS devices</li><li>Optimizing app for production release</li><li>JavaScript thread blocking or main thread blocking</li><li>Large bundle size impacting app startup time</li><li>Profiling and identifying performance bottlenecks</li></ul>
|
|
<h2>Core Concepts</h2>
|
|
<h3>React Native Architecture</h3>
|
|
<p><strong>Thread Model</strong>:</p>
|
|
<ul><li><strong>JavaScript Thread</strong>: Runs React code, business logic</li><li><strong>Main (UI) Thread</strong>: Native iOS UI rendering</li><li><strong>Shadow Thread</strong>: Layout calculations (Yoga)</li><li><strong>Bridge</strong>: Serializes data between JS and native (batched async)</li></ul>
|
|
<p><strong>New Architecture (Fabric + TurboModules)</strong>:</p>
|
|
<ul><li>Direct JSI (JavaScript Interface) communication</li><li>Synchronous native calls possible</li><li>Faster bridge, reduced overhead</li><li>Incremental adoption available</li></ul>
|
|
<h3>Performance Bottlenecks</h3>
|
|
<p><strong>Common Issues</strong>:</p>
|
|
<ul><li>Bridge congestion (too many messages)</li><li>Excessive re-renders in React components</li><li>Heavy JavaScript computations blocking thread</li><li>Large lists without virtualization</li><li>Unoptimized images and assets</li><li>Memory leaks from listeners and timers</li></ul>
|
|
<p><strong>iOS-Specific</strong>:</p>
|
|
<ul><li>UIKit bridging overhead</li><li>CoreGraphics rendering costs</li><li>Allocation pressure (ARC overhead)</li><li>Disk I/O on main thread</li></ul>
|
|
<h3>Hermes JavaScript Engine</h3>
|
|
<p><strong>Benefits</strong>:</p>
|
|
<ul><li>Ahead-of-time compilation (faster startup)</li><li>Reduced memory footprint</li><li>Optimized bytecode</li><li>Better garbage collection</li></ul>
|
|
<p><strong>Trade-offs</strong>:</p>
|
|
<ul><li>No JIT (slightly slower runtime in some cases)</li><li>Default in React Native 0.70+</li><li>iOS 64-bit only</li></ul>
|
|
<hr>
|
|
<h2>Patterns</h2>
|
|
<h3>Pattern 1: FlatList Optimization</h3>
|
|
<pre><code class="lang-typescript">import React, { useCallback } from 'react';
|
|
import { FlatList, View, Text, StyleSheet } from 'react-native';
|
|
|
|
interface Item {
|
|
id: string;
|
|
title: string;
|
|
description: string;
|
|
}
|
|
|
|
// Memoized item component
|
|
const ListItem = React.memo<{ item: Item }>(({ item }) => {
|
|
return (
|
|
<View style={styles.item}>
|
|
<Text style={styles.title}>{item.title}</Text>
|
|
<Text style={styles.description}>{item.description}</Text>
|
|
</View>
|
|
);
|
|
});
|
|
|
|
function OptimizedList({ data }: { data: Item[] }) {
|
|
// Memoize key extractor
|
|
const keyExtractor = useCallback((item: Item) => item.id, []);
|
|
|
|
// Memoize render item
|
|
const renderItem = useCallback(
|
|
({ item }: { item: Item }) => <ListItem item={item} />,
|
|
[]
|
|
);
|
|
|
|
return (
|
|
<FlatList
|
|
data={data}
|
|
renderItem={renderItem}
|
|
keyExtractor={keyExtractor}
|
|
|
|
// Performance optimizations
|
|
removeClippedSubviews={true} // Unmount offscreen items
|
|
maxToRenderPerBatch={10} // Items per render batch
|
|
updateCellsBatchingPeriod={50} // ms between batches
|
|
initialNumToRender={10} // Initial render count
|
|
windowSize={5} // Viewports to render (3 = current + 1 above + 1 below)
|
|
|
|
// iOS-specific optimizations
|
|
maintainVisibleContentPosition={{
|
|
minIndexForVisible: 0,
|
|
autoscrollToTopThreshold: 10,
|
|
}}
|
|
|
|
// Prevent re-renders
|
|
getItemLayout={(data, index) => ({
|
|
length: 80, // Fixed item height
|
|
offset: 80 * index,
|
|
index,
|
|
})}
|
|
/>
|
|
);
|
|
}
|
|
|
|
const styles = StyleSheet.create({
|
|
item: { height: 80, padding: 16 },
|
|
title: { fontSize: 16, fontWeight: 'bold' },
|
|
description: { fontSize: 14, color: '#666' },
|
|
});</code></pre>
|
|
<p><strong>Benefits</strong>:</p>
|
|
<ul><li>60fps scrolling on large lists</li><li>Reduced memory usage</li><li>Efficient re-renders</li><li>iOS-optimized viewport handling</li></ul>
|
|
<h3>Pattern 2: React.memo and useMemo</h3>
|
|
<pre><code class="lang-typescript">import React, { useMemo, useCallback, useState } from 'react';
|
|
import { View, Text, Pressable } from 'react-native';
|
|
|
|
// Expensive computation
|
|
function expensiveCalculation(items: number[]): number {
|
|
console.log('Running expensive calculation...');
|
|
return items.reduce((sum, item) => sum + item, 0);
|
|
}
|
|
|
|
// Memoized child component
|
|
interface ChildProps {
|
|
count: number;
|
|
onIncrement: () => void;
|
|
}
|
|
|
|
const ChildComponent = React.memo<ChildProps>(({ count, onIncrement }) => {
|
|
console.log('ChildComponent render');
|
|
return (
|
|
<View>
|
|
<Text>Count: {count}</Text>
|
|
<Pressable onPress={onIncrement}>
|
|
<Text>Increment</Text>
|
|
</Pressable>
|
|
</View>
|
|
);
|
|
});
|
|
|
|
function ParentComponent() {
|
|
const [count, setCount] = useState(0);
|
|
const [items] = useState([1, 2, 3, 4, 5]);
|
|
|
|
// Memoize expensive computation
|
|
const total = useMemo(() => expensiveCalculation(items), [items]);
|
|
|
|
// Memoize callback to prevent child re-renders
|
|
const handleIncrement = useCallback(() => {
|
|
setCount((c) => c + 1);
|
|
}, []);
|
|
|
|
return (
|
|
<View>
|
|
<Text>Total: {total}</Text>
|
|
<ChildComponent count={count} onIncrement={handleIncrement} />
|
|
</View>
|
|
);
|
|
}</code></pre>
|
|
<p><strong>When to use</strong>:</p>
|
|
<ul><li>Expensive computations</li><li>Preventing unnecessary re-renders</li><li>Child components receiving callback props</li><li>Lists with many items</li></ul>
|
|
<h3>Pattern 3: React Native Reanimated 2</h3>
|
|
<pre><code class="lang-typescript">import Animated, {
|
|
useSharedValue,
|
|
useAnimatedStyle,
|
|
withSpring,
|
|
withTiming,
|
|
} from 'react-native-reanimated';
|
|
import { Gesture, GestureDetector } from 'react-native-gesture-handler';
|
|
|
|
function AnimatedBox() {
|
|
const offset = useSharedValue(0);
|
|
const scale = useSharedValue(1);
|
|
|
|
// Gesture runs on UI thread (no bridge)
|
|
const pan = Gesture.Pan()
|
|
.onChange((event) => {
|
|
offset.value += event.changeX;
|
|
})
|
|
.onEnd(() => {
|
|
offset.value = withSpring(0);
|
|
});
|
|
|
|
const tap = Gesture.Tap()
|
|
.onBegin(() => {
|
|
scale.value = withTiming(1.2, { duration: 100 });
|
|
})
|
|
.onFinalize(() => {
|
|
scale.value = withSpring(1);
|
|
});
|
|
|
|
// Animated style runs on UI thread
|
|
const animatedStyle = useAnimatedStyle(() => ({
|
|
transform: [
|
|
{ translateX: offset.value },
|
|
{ scale: scale.value },
|
|
],
|
|
}));
|
|
|
|
const composed = Gesture.Simultaneous(pan, tap);
|
|
|
|
return (
|
|
<GestureDetector gesture={composed}>
|
|
<Animated.View style={[styles.box, animatedStyle]} />
|
|
</GestureDetector>
|
|
);
|
|
}</code></pre>
|
|
<p><strong>Benefits</strong>:</p>
|
|
<ul><li>60fps animations (runs on UI thread)</li><li>No bridge communication during animation</li><li>Native iOS spring physics</li><li>Gesture-driven animations</li></ul>
|
|
<h3>Pattern 4: Image Optimization</h3>
|
|
<pre><code class="lang-typescript">import React from 'react';
|
|
import { Image, Platform } from 'react-native';
|
|
import FastImage from 'react-native-fast-image';
|
|
|
|
// Use FastImage for better performance
|
|
function OptimizedImage({ uri }: { uri: string }) {
|
|
return (
|
|
<FastImage
|
|
source={{
|
|
uri,
|
|
priority: FastImage.priority.high,
|
|
cache: FastImage.cacheControl.immutable,
|
|
}}
|
|
style={{ width: 200, height: 200 }}
|
|
resizeMode={FastImage.resizeMode.cover}
|
|
/>
|
|
);
|
|
}
|
|
|
|
// Image size optimization
|
|
function ResponsiveImage({ baseUri }: { baseUri: string }) {
|
|
// Use appropriate image size for device
|
|
const scale = Platform.select({
|
|
ios: (Image as any).getSize ? '@3x' : '@2x',
|
|
default: '@2x',
|
|
});
|
|
|
|
return (
|
|
<Image
|
|
source={{ uri: `${baseUri}${scale}.jpg` }}
|
|
style={{ width: 200, height: 200 }}
|
|
resizeMode="cover"
|
|
// Load placeholder while loading
|
|
defaultSource={require('./placeholder.png')}
|
|
/>
|
|
);
|
|
}
|
|
|
|
// Lazy image loading
|
|
function LazyImage({ uri }: { uri: string }) {
|
|
const [loaded, setLoaded] = React.useState(false);
|
|
|
|
return (
|
|
<>
|
|
{!loaded && <Image source={require('./placeholder.png')} />}
|
|
<Image
|
|
source={{ uri }}
|
|
style={{ display: loaded ? 'flex' : 'none' }}
|
|
onLoad={() => setLoaded(true)}
|
|
/>
|
|
</>
|
|
);
|
|
}</code></pre>
|
|
<p><strong>When to use</strong>:</p>
|
|
<ul><li>Multiple images on screen</li><li>Remote image loading</li><li>Large image files</li><li>Image-heavy feeds</li></ul>
|
|
<h3>Pattern 5: Bundle Size Optimization</h3>
|
|
<pre><code class="lang-javascript">// metro.config.js
|
|
const { getDefaultConfig } = require('expo/metro-config');
|
|
|
|
const config = getDefaultConfig(__dirname);
|
|
|
|
// Enable tree shaking
|
|
config.transformer.minifierConfig = {
|
|
keep_classnames: false,
|
|
keep_fnames: false,
|
|
mangle: {
|
|
keep_classnames: false,
|
|
keep_fnames: false,
|
|
},
|
|
compress: {
|
|
drop_console: true, // Remove console.log in production
|
|
dead_code: true,
|
|
collapse_vars: true,
|
|
reduce_vars: true,
|
|
},
|
|
};
|
|
|
|
// Enable inlining for smaller bundle
|
|
config.transformer.experimentalImportSupport = true;
|
|
config.transformer.inlineRequires = true;
|
|
|
|
module.exports = config;</code></pre>
|
|
<pre><code class="lang-typescript">// Dynamic imports for code splitting
|
|
import React, { lazy, Suspense } from 'react';
|
|
|
|
// Lazy load heavy screens
|
|
const ProfileScreen = lazy(() => import('./screens/ProfileScreen'));
|
|
const SettingsScreen = lazy(() => import('./screens/SettingsScreen'));
|
|
|
|
function App() {
|
|
return (
|
|
<Suspense fallback={<LoadingScreen />}>
|
|
<ProfileScreen />
|
|
</Suspense>
|
|
);
|
|
}</code></pre>
|
|
<p><strong>Benefits</strong>:</p>
|
|
<ul><li>Smaller app bundle</li><li>Faster app startup</li><li>Reduced memory footprint</li><li>On-demand feature loading</li></ul>
|
|
<h3>Pattern 6: Memory Leak Prevention</h3>
|
|
<pre><code class="lang-typescript">import React, { useEffect, useRef } from 'react';
|
|
import { NativeEventEmitter, NativeModules, AppState } from 'react-native';
|
|
|
|
function MemorySafeComponent() {
|
|
const isMounted = useRef(true);
|
|
|
|
useEffect(() => {
|
|
// Cleanup flag
|
|
return () => {
|
|
isMounted.current = false;
|
|
};
|
|
}, []);
|
|
|
|
useEffect(() => {
|
|
// Timer cleanup
|
|
const timer = setTimeout(() => {
|
|
if (isMounted.current) {
|
|
console.log('Timer fired');
|
|
}
|
|
}, 1000);
|
|
|
|
return () => clearTimeout(timer);
|
|
}, []);
|
|
|
|
useEffect(() => {
|
|
// Event listener cleanup
|
|
const eventEmitter = new NativeEventEmitter(NativeModules.MyModule);
|
|
const subscription = eventEmitter.addListener('onEvent', (data) => {
|
|
if (isMounted.current) {
|
|
console.log(data);
|
|
}
|
|
});
|
|
|
|
return () => subscription.remove();
|
|
}, []);
|
|
|
|
useEffect(() => {
|
|
// AppState listener cleanup
|
|
const subscription = AppState.addEventListener('change', (state) => {
|
|
console.log('App state:', state);
|
|
});
|
|
|
|
return () => subscription.remove();
|
|
}, []);
|
|
|
|
return null;
|
|
}</code></pre>
|
|
<p><strong>When to use</strong>:</p>
|
|
<ul><li>Components with timers</li><li>Event listeners</li><li>Network requests</li><li>Background tasks</li></ul>
|
|
<h3>Pattern 7: iOS Performance Profiling</h3>
|
|
<pre><code class="lang-typescript">// Using Performance API
|
|
import { Performance } from 'react-native-performance';
|
|
|
|
const perf = new Performance();
|
|
|
|
// Measure component render time
|
|
function MeasuredComponent() {
|
|
useEffect(() => {
|
|
perf.mark('component-mount');
|
|
return () => {
|
|
perf.mark('component-unmount');
|
|
perf.measure('component-lifetime', 'component-mount', 'component-unmount');
|
|
};
|
|
}, []);
|
|
|
|
return <View />;
|
|
}
|
|
|
|
// Measure async operations
|
|
async function fetchData() {
|
|
perf.mark('fetch-start');
|
|
const data = await fetch('https://api.example.com/data');
|
|
perf.mark('fetch-end');
|
|
perf.measure('fetch-duration', 'fetch-start', 'fetch-end');
|
|
|
|
const measures = perf.getEntriesByType('measure');
|
|
console.log('Fetch took:', measures[0].duration, 'ms');
|
|
}</code></pre>
|
|
<pre><code class="lang-bash"># iOS profiling with Xcode Instruments
|
|
# 1. Run app in release mode
|
|
npm run ios --configuration Release
|
|
|
|
# 2. Open Xcode → Product → Profile
|
|
# 3. Choose Instruments template:
|
|
# - Time Profiler (CPU usage)
|
|
# - Allocations (memory usage)
|
|
# - Leaks (memory leaks)
|
|
# - Core Animation (FPS, rendering)
|
|
|
|
# 3. Analyze performance bottlenecks</code></pre>
|
|
<p><strong>When to use</strong>:</p>
|
|
<ul><li>Production optimization</li><li>Identifying slow operations</li><li>Memory leak detection</li><li>Frame rate analysis</li></ul>
|
|
<h3>Pattern 8: Bridge Optimization</h3>
|
|
<pre><code class="lang-typescript">// ❌ Bad: Too many bridge calls
|
|
function BadComponent({ items }: { items: string[] }) {
|
|
return (
|
|
<View>
|
|
{items.map((item) => (
|
|
<NativeModule.processItem key={item} item={item} />
|
|
))}
|
|
</View>
|
|
);
|
|
}
|
|
|
|
// ✅ Good: Batch bridge calls
|
|
function GoodComponent({ items }: { items: string[] }) {
|
|
useEffect(() => {
|
|
// Process all items in one native call
|
|
NativeModule.processItems(items);
|
|
}, [items]);
|
|
|
|
return <View>{/* render results */}</View>;
|
|
}
|
|
|
|
// ❌ Bad: Frequent state updates across bridge
|
|
const [data, setData] = useState([]);
|
|
setInterval(() => {
|
|
NativeModule.getData().then(setData); // Bridge call every interval
|
|
}, 100);
|
|
|
|
// ✅ Good: Use event emitter for frequent updates
|
|
useEffect(() => {
|
|
const subscription = NativeModule.subscribeToData((data) => {
|
|
setData(data); // Native pushes updates
|
|
});
|
|
|
|
return () => subscription.remove();
|
|
}, []);</code></pre>
|
|
<p><strong>Benefits</strong>:</p>
|
|
<ul><li>Reduced bridge congestion</li><li>Better batching of operations</li><li>Lower overhead per operation</li><li>Improved responsiveness</li></ul>
|
|
<hr>
|
|
<h2>Quick Reference</h2>
|
|
<h3>Performance Checklist</h3>
|
|
<pre><code>✅ DO: Use FlatList/SectionList for long lists
|
|
✅ DO: Memoize expensive computations (useMemo)
|
|
✅ DO: Memoize callbacks (useCallback)
|
|
✅ DO: Use React.memo for pure components
|
|
✅ DO: Enable Hermes engine
|
|
✅ DO: Use Reanimated 2 for animations
|
|
✅ DO: Optimize images (FastImage, lazy loading)
|
|
✅ DO: Clean up timers and listeners
|
|
✅ DO: Profile with Xcode Instruments
|
|
✅ DO: Remove console.log in production
|
|
|
|
❌ DON'T: Render huge lists without virtualization
|
|
❌ DON'T: Use inline functions in render
|
|
❌ DON'T: Animate with setState (use Reanimated)
|
|
❌ DON'T: Store large objects in state
|
|
❌ DON'T: Make frequent bridge calls
|
|
❌ DON'T: Block main thread with heavy operations
|
|
❌ DON'T: Forget to clean up subscriptions
|
|
❌ DON'T: Use development mode for benchmarking</code></pre>
|
|
<h3>FlatList Props for Performance</h3>
|
|
<pre><code>Prop | Value | Effect
|
|
-------------------------------|----------------|------------------
|
|
removeClippedSubviews | true | Unmount offscreen
|
|
maxToRenderPerBatch | 10 | Items per batch
|
|
updateCellsBatchingPeriod | 50 | ms between batches
|
|
initialNumToRender | 10 | Initial items
|
|
windowSize | 5 | Viewport multiplier
|
|
getItemLayout | Function | Skip measurement</code></pre>
|
|
<h3>Profiling Commands</h3>
|
|
<pre><code class="lang-bash"># iOS release build
|
|
npm run ios --configuration Release
|
|
|
|
# Bundle analyzer
|
|
npx react-native-bundle-visualizer
|
|
|
|
# Performance monitor (dev)
|
|
# Shake device → Show Performance Monitor
|
|
|
|
# Xcode Instruments
|
|
# Product → Profile → Choose Instrument
|
|
|
|
# Flipper profiling
|
|
# React DevTools → Profiler</code></pre>
|
|
<hr>
|
|
<h2>Anti-Patterns</h2>
|
|
<p>❌ <strong>Animating with setState</strong>: Causes bridge congestion and dropped frames ✅ Use Reanimated 2 for animations running on UI thread</p>
|
|
<p>❌ <strong>Inline functions in FlatList renderItem</strong>: Creates new functions every render ✅ Use useCallback to memoize render functions</p>
|
|
<p>❌ <strong>Loading all data at once</strong>: Memory issues with large datasets ✅ Use pagination, infinite scroll, or virtualized lists</p>
|
|
<p>❌ <strong>Not cleaning up listeners</strong>: Memory leaks and performance degradation ✅ Return cleanup functions from useEffect hooks</p>
|
|
<p>❌ <strong>console.log in production</strong>: Significant performance overhead ✅ Remove or use __DEV__ check, strip in Metro config</p>
|
|
<p>❌ <strong>Synchronous bridge calls</strong>: Blocks JavaScript thread ✅ Use async/await with promises, batch operations</p>
|
|
<p>❌ <strong>Large bundle with no code splitting</strong>: Slow startup time ✅ Use dynamic imports and lazy loading for heavy features</p>
|
|
<p>❌ <strong>Profiling in development mode</strong>: Misleading results (dev warnings, no optimization) ✅ Always profile in release mode with production builds</p>
|
|
<hr>
|
|
<h2>Related Skills</h2>
|
|
<ul><li><code>react-native-setup.md</code> - Hermes configuration and optimization</li><li><code>react-native-navigation.md</code> - Navigation performance patterns</li><li><code>react-native-native-modules.md</code> - Optimizing bridge communication</li><li><code>frontend-performance.md</code> - General React optimization techniques</li><li><code>ios-testing.md</code> - Performance testing on iOS</li><li><code>swiftui-architecture.md</code> - Understanding iOS rendering pipeline</li></ul>
|
|
<hr>
|
|
<p><strong>Last Updated</strong>: 2025-10-18 <strong>Format Version</strong>: 1.0 (Atomic)</p>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/mobile-react-native-performance.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |