Files
skills/public/mobile-react-native-setup.html
zeekay 747dafba10 Register WebMCP tools on every page, and name each page's twin from site.py
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.
2026-10-26 20:57:05 -07:00

479 lines
26 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-setup</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-setup">
<link rel="alternate" type="text/markdown" href="/mobile-react-native-setup.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-setup.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-setup</h1><p class="lede">Starting a new React Native project for iOS development</p><h1>React Native Setup</h1>
<p><strong>Scope</strong>: React Native project setup, Expo vs bare workflow, iOS development environment, tooling configuration <strong>Lines</strong>: ~320 <strong>Last Updated</strong>: 2025-10-18</p>
<h2>When to Use This Skill</h2>
<p>Activate this skill when:</p>
<ul><li>Starting a new React Native project for iOS development</li><li>Choosing between Expo and bare workflow approaches</li><li>Setting up iOS development environment and dependencies</li><li>Configuring Metro bundler and build tools</li><li>Troubleshooting React Native setup and installation issues</li><li>Migrating from Expo to bare workflow</li><li>Configuring TypeScript and ESLint for React Native projects</li></ul>
<h2>Core Concepts</h2>
<h3>Expo vs Bare Workflow</h3>
<p><strong>Expo Managed</strong>:</p>
<ul><li>Pre-configured development environment</li><li>OTA updates via Expo Go app</li><li>Limited access to native modules</li><li>Best for: MVPs, rapid prototyping, simple apps</li><li>No need for Xcode initially</li></ul>
<p><strong>Expo Bare</strong>:</p>
<ul><li>Expo libraries + full native access</li><li>Custom native modules available</li><li>Build with EAS or locally</li><li>Best for: Apps needing custom native code</li><li>Requires Xcode and CocoaPods</li></ul>
<p><strong>React Native CLI (Bare)</strong>:</p>
<ul><li>Full control over native code</li><li>Direct access to iOS APIs</li><li>More complex setup</li><li>Best for: Complex apps, existing native code integration</li><li>Requires Xcode, CocoaPods, Ruby environment</li></ul>
<h3>Metro Bundler</h3>
<p><strong>Metro Role</strong>:</p>
<ul><li>JavaScript bundler for React Native</li><li>Hot reloading and fast refresh</li><li>Module resolution and transformation</li><li>Source maps for debugging</li></ul>
<p><strong>Key Features</strong>:</p>
<ul><li>Incremental bundling (fast rebuilds)</li><li>Tree shaking (remove unused code)</li><li>Asset resolution (images, fonts)</li><li>Platform-specific extensions (.ios.ts, .android.ts)</li></ul>
<h3>iOS Development Environment</h3>
<p><strong>Required Tools</strong>:</p>
<ul><li><strong>Xcode</strong>: Latest stable version (15.0+)</li><li><strong>Command Line Tools</strong>: <code>xcode-select --install</code></li><li><strong>CocoaPods</strong>: <code>sudo gem install cocoapods</code></li><li><strong>Node.js</strong>: LTS version (18.x or 20.x)</li><li><strong>Watchman</strong>: <code>brew install watchman</code> (file watching)</li></ul>
<p><strong>Optional Tools</strong>:</p>
<ul><li><strong>Ruby Version Manager</strong>: rbenv or rvm</li><li><strong>iOS Simulator</strong>: Xcode includes multiple iOS versions</li><li><strong>Physical Device</strong>: For hardware testing</li></ul>
<hr>
<h2>Patterns</h2>
<h3>Pattern 1: Expo Managed Setup</h3>
<pre><code class="lang-bash"># Create new Expo project
npx create-expo-app@latest MyApp --template blank-typescript
cd MyApp
# Install dependencies
npm install
# Start development server
npx expo start
# Run on iOS simulator
npx expo start --ios
# Install additional Expo packages
npx expo install expo-camera expo-location</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Building simple to moderate complexity apps</li><li>Need OTA updates</li><li>Don&#x27;t require custom native modules</li><li>Rapid prototyping phase</li><li>Team without iOS development experience</li></ul>
<h3>Pattern 2: React Native CLI Setup</h3>
<pre><code class="lang-bash"># Create new React Native project
npx react-native@latest init MyApp --template react-native-template-typescript
cd MyApp
# Install iOS dependencies
cd ios &amp;&amp; pod install &amp;&amp; cd ..
# Start Metro bundler
npm start
# Run on iOS simulator (separate terminal)
npm run ios
# Run on specific simulator
npm run ios -- --simulator=&quot;iPhone 15 Pro&quot;</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Need custom native modules</li><li>Existing native iOS code to integrate</li><li>Full control over native build process</li><li>Complex native functionality requirements</li><li>Performance-critical applications</li></ul>
<h3>Pattern 3: Expo Bare Workflow Setup</h3>
<pre><code class="lang-bash"># Create Expo bare workflow project
npx create-expo-app@latest MyApp --template bare-minimum
cd MyApp
# Install dependencies and pods
npm install
cd ios &amp;&amp; pod install &amp;&amp; cd ..
# Prebuild native projects
npx expo prebuild --clean
# Run on iOS
npx expo run:ios
# Install Expo modules
npx expo install expo-camera expo-notifications</code></pre>
<p><strong>Benefits</strong>:</p>
<ul><li>Best of both worlds (Expo + native access)</li><li>Use Expo libraries with custom native code</li><li>EAS Build integration</li><li>Easier native module integration than pure RN CLI</li></ul>
<h3>Pattern 4: TypeScript Configuration</h3>
<pre><code class="lang-json">// tsconfig.json
{
&quot;extends&quot;: &quot;expo/tsconfig.base&quot;,
&quot;compilerOptions&quot;: {
&quot;strict&quot;: true,
&quot;target&quot;: &quot;ES2022&quot;,
&quot;lib&quot;: [&quot;ES2022&quot;],
&quot;jsx&quot;: &quot;react-native&quot;,
&quot;moduleResolution&quot;: &quot;node&quot;,
&quot;allowSyntheticDefaultImports&quot;: true,
&quot;esModuleInterop&quot;: true,
&quot;skipLibCheck&quot;: true,
&quot;resolveJsonModule&quot;: true,
&quot;isolatedModules&quot;: true,
&quot;noEmit&quot;: true,
&quot;baseUrl&quot;: &quot;.&quot;,
&quot;paths&quot;: {
&quot;@components/*&quot;: [&quot;src/components/*&quot;],
&quot;@screens/*&quot;: [&quot;src/screens/*&quot;],
&quot;@utils/*&quot;: [&quot;src/utils/*&quot;],
&quot;@types/*&quot;: [&quot;src/types/*&quot;]
}
},
&quot;include&quot;: [&quot;**/*.ts&quot;, &quot;**/*.tsx&quot;],
&quot;exclude&quot;: [&quot;node_modules&quot;, &quot;ios&quot;, &quot;android&quot;]
}</code></pre>
<p><strong>Benefits</strong>:</p>
<ul><li>Type safety for React Native APIs</li><li>Better IDE support and autocomplete</li><li>Catch errors at compile time</li><li>Path aliases for cleaner imports</li></ul>
<h3>Pattern 5: Metro Configuration</h3>
<pre><code class="lang-javascript">// metro.config.js
const { getDefaultConfig } = require(&#x27;expo/metro-config&#x27;);
const config = getDefaultConfig(__dirname);
// Add custom asset extensions
config.resolver.assetExts.push(&#x27;db&#x27;, &#x27;json&#x27;, &#x27;txt&#x27;);
// Add custom source extensions
config.resolver.sourceExts.push(&#x27;jsx&#x27;, &#x27;js&#x27;, &#x27;ts&#x27;, &#x27;tsx&#x27;, &#x27;cjs&#x27;, &#x27;mjs&#x27;);
// Platform-specific extensions order
config.resolver.platforms = [&#x27;ios&#x27;, &#x27;android&#x27;, &#x27;native&#x27;];
// Watchman configuration
config.watchFolders = [__dirname];
// Transformer configuration for SVG
config.transformer.babelTransformerPath = require.resolve(&#x27;react-native-svg-transformer&#x27;);
config.resolver.assetExts = config.resolver.assetExts.filter((ext) =&gt; ext !== &#x27;svg&#x27;);
config.resolver.sourceExts.push(&#x27;svg&#x27;);
module.exports = config;</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Custom asset types (SVG, fonts, etc.)</li><li>Monorepo setup with multiple packages</li><li>Custom module resolution</li><li>Performance optimization (caching)</li></ul>
<h3>Pattern 6: Package.json Scripts</h3>
<pre><code class="lang-json">{
&quot;name&quot;: &quot;MyApp&quot;,
&quot;version&quot;: &quot;1.0.0&quot;,
&quot;scripts&quot;: {
&quot;start&quot;: &quot;expo start&quot;,
&quot;ios&quot;: &quot;expo start --ios&quot;,
&quot;android&quot;: &quot;expo start --android&quot;,
&quot;web&quot;: &quot;expo start --web&quot;,
&quot;lint&quot;: &quot;eslint . --ext .js,.jsx,.ts,.tsx&quot;,
&quot;lint:fix&quot;: &quot;eslint . --ext .js,.jsx,.ts,.tsx --fix&quot;,
&quot;type-check&quot;: &quot;tsc --noEmit&quot;,
&quot;test&quot;: &quot;jest&quot;,
&quot;test:watch&quot;: &quot;jest --watch&quot;,
&quot;clean&quot;: &quot;rm -rf node_modules ios/Pods ios/build android/build&quot;, # Cleans build artifacts only - safe to run
&quot;clean:metro&quot;: &quot;rm -rf $TMPDIR/metro-* $TMPDIR/haste-*&quot;, # Cleans Metro bundler cache - safe to run
&quot;pod-install&quot;: &quot;cd ios &amp;&amp; pod install &amp;&amp; cd ..&quot;,
&quot;prebuild&quot;: &quot;expo prebuild --clean&quot;,
&quot;build:ios&quot;: &quot;eas build --platform ios&quot;
},
&quot;dependencies&quot;: {
&quot;expo&quot;: &quot;~50.0.0&quot;,
&quot;react&quot;: &quot;18.2.0&quot;,
&quot;react-native&quot;: &quot;0.73.0&quot;
},
&quot;devDependencies&quot;: {
&quot;@babel/core&quot;: &quot;^7.23.0&quot;,
&quot;@types/react&quot;: &quot;~18.2.0&quot;,
&quot;@typescript-eslint/eslint-plugin&quot;: &quot;^6.0.0&quot;,
&quot;@typescript-eslint/parser&quot;: &quot;^6.0.0&quot;,
&quot;eslint&quot;: &quot;^8.50.0&quot;,
&quot;eslint-config-expo&quot;: &quot;^7.0.0&quot;,
&quot;typescript&quot;: &quot;^5.2.0&quot;
}
}</code></pre>
<p><strong>Benefits</strong>:</p>
<ul><li>Standardized commands across team</li><li>Easy cleanup and rebuilding</li><li>Integrated linting and type checking</li><li>iOS-specific build shortcuts</li></ul>
<h3>Pattern 7: Environment Setup Verification</h3>
<pre><code class="lang-bash">#!/bin/bash
# check-setup.sh - Verify React Native environment
echo &quot;Checking React Native iOS setup...&quot;
# Node.js version
echo -n &quot;Node.js: &quot;
node --version
# npm version
echo -n &quot;npm: &quot;
npm --version
# Watchman
echo -n &quot;Watchman: &quot;
watchman --version 2&gt;/dev/null || echo &quot;Not installed&quot;
# CocoaPods
echo -n &quot;CocoaPods: &quot;
pod --version 2&gt;/dev/null || echo &quot;Not installed&quot;
# Xcode
echo -n &quot;Xcode: &quot;
xcodebuild -version | head -n1
# Command Line Tools
echo -n &quot;Command Line Tools: &quot;
xcode-select -p
# iOS Simulators
echo &quot;Available iOS Simulators:&quot;
xcrun simctl list devices available | grep iPhone
# Ruby version
echo -n &quot;Ruby: &quot;
ruby --version
echo &quot;Setup check complete!&quot;</code></pre>
<p><strong>When to use</strong>:</p>
<ul><li>Onboarding new developers</li><li>Troubleshooting setup issues</li><li>CI/CD environment validation</li><li>Before major version upgrades</li></ul>
<hr>
<h2>Quick Reference</h2>
<h3>Common Commands</h3>
<pre><code>Command | Purpose | When to Use
-------------------------------------|--------------------------------|------------------
npx create-expo-app MyApp | Create Expo project | New Expo app
npx react-native init MyApp | Create RN CLI project | New bare workflow
cd ios &amp;&amp; pod install | Install iOS dependencies | After adding packages
npx expo start --ios | Run Expo on iOS | Development
npm run ios | Run RN CLI on iOS | Development
npm run clean:metro | Clear Metro cache | Bundler issues
npx expo prebuild --clean | Regenerate native folders | Config changes
xcodebuild clean | Clean Xcode build | Build issues
xcrun simctl list devices | List iOS simulators | Check available devices</code></pre>
<h3>Troubleshooting Guide</h3>
<pre><code>✅ DO: Keep Node.js on LTS version (18.x or 20.x)
✅ DO: Run pod install after every package addition
✅ DO: Clear Metro cache when seeing stale code
✅ DO: Use Watchman to improve file watching performance
✅ DO: Keep Xcode and Command Line Tools updated
❌ DON&#x27;T: Mix package managers (npm/yarn/pnpm)
❌ DON&#x27;T: Skip pod install after dependency changes
❌ DON&#x27;T: Use outdated Node.js versions
❌ DON&#x27;T: Ignore Xcode update prompts
❌ DON&#x27;T: Commit ios/Pods directory to git</code></pre>
<h3>Node Version Requirements</h3>
<pre><code>React Native Version | Node.js Version | Notes
---------------------|--------------------|-----------------------
0.73.x | 18.x LTS | Latest stable
0.72.x | 16.x - 18.x | Expo SDK 49
0.71.x | 16.x - 18.x | Expo SDK 48
0.70.x | 14.x - 18.x | Legacy support</code></pre>
<hr>
<h2>Anti-Patterns</h2>
<p>❌ <strong>Using wrong Node.js version</strong>: Breaks native modules and build tools ✅ Use nvm or fnm to manage Node versions, stick to LTS releases</p>
<p>❌ <strong>Skipping pod install</strong>: Leads to missing native dependencies and runtime crashes ✅ Run <code>cd ios &amp;&amp; pod install</code> after every package addition or removal</p>
<p>❌ <strong>Committing Pods directory</strong>: Bloats repository with thousands of files ✅ Add <code>ios/Pods/</code> to .gitignore, commit Podfile.lock instead</p>
<p>❌ <strong>Mixing Expo and bare workflow randomly</strong>: Confusion and broken builds ✅ Choose workflow upfront, migrate deliberately with <code>expo prebuild</code></p>
<p>❌ <strong>Ignoring Metro cache issues</strong>: Stale bundler state causes mysterious bugs ✅ Clear cache with <code>npm run clean:metro</code> or <code>rm -rf $TMPDIR/metro-*</code> (safe - cleans Metro cache)</p>
<p>❌ <strong>Not using Watchman on macOS</strong>: Slow file watching and reload issues ✅ Install Watchman with Homebrew: <code>brew install watchman</code></p>
<p>❌ <strong>Running npm install in ios/ folder</strong>: Breaks CocoaPods dependency resolution ✅ Only run npm install at project root, use pod install for iOS dependencies</p>
<p>❌ <strong>Using deprecated react-native-cli globally</strong>: Old CLI causes compatibility issues ✅ Use npx with latest version: <code>npx react-native@latest init MyApp</code></p>
<hr>
<h2>Related Skills</h2>
<ul><li><code>react-native-navigation.md</code> - Multi-screen navigation and routing</li><li><code>react-native-native-modules.md</code> - Bridging to native iOS code</li><li><code>react-native-performance.md</code> - Optimization and profiling</li><li><code>swiftui-architecture.md</code> - Understanding iOS app structure</li><li><code>swift-concurrency.md</code> - Native async patterns for bridging</li><li><code>ios-testing.md</code> - Testing React Native apps on iOS</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-setup.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>