mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
479 lines
26 KiB
HTML
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="alternate" type="text/markdown" href="/mobile-react-native-setup.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/mobile-react-native-setup">
|
|
</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'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 && pod install && cd ..
|
|
|
|
# Start Metro bundler
|
|
npm start
|
|
|
|
# Run on iOS simulator (separate terminal)
|
|
npm run ios
|
|
|
|
# Run on specific simulator
|
|
npm run ios -- --simulator="iPhone 15 Pro"</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 && pod install && 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
|
|
{
|
|
"extends": "expo/tsconfig.base",
|
|
"compilerOptions": {
|
|
"strict": true,
|
|
"target": "ES2022",
|
|
"lib": ["ES2022"],
|
|
"jsx": "react-native",
|
|
"moduleResolution": "node",
|
|
"allowSyntheticDefaultImports": true,
|
|
"esModuleInterop": true,
|
|
"skipLibCheck": true,
|
|
"resolveJsonModule": true,
|
|
"isolatedModules": true,
|
|
"noEmit": true,
|
|
"baseUrl": ".",
|
|
"paths": {
|
|
"@components/*": ["src/components/*"],
|
|
"@screens/*": ["src/screens/*"],
|
|
"@utils/*": ["src/utils/*"],
|
|
"@types/*": ["src/types/*"]
|
|
}
|
|
},
|
|
"include": ["**/*.ts", "**/*.tsx"],
|
|
"exclude": ["node_modules", "ios", "android"]
|
|
}</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('expo/metro-config');
|
|
|
|
const config = getDefaultConfig(__dirname);
|
|
|
|
// Add custom asset extensions
|
|
config.resolver.assetExts.push('db', 'json', 'txt');
|
|
|
|
// Add custom source extensions
|
|
config.resolver.sourceExts.push('jsx', 'js', 'ts', 'tsx', 'cjs', 'mjs');
|
|
|
|
// Platform-specific extensions order
|
|
config.resolver.platforms = ['ios', 'android', 'native'];
|
|
|
|
// Watchman configuration
|
|
config.watchFolders = [__dirname];
|
|
|
|
// Transformer configuration for SVG
|
|
config.transformer.babelTransformerPath = require.resolve('react-native-svg-transformer');
|
|
config.resolver.assetExts = config.resolver.assetExts.filter((ext) => ext !== 'svg');
|
|
config.resolver.sourceExts.push('svg');
|
|
|
|
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">{
|
|
"name": "MyApp",
|
|
"version": "1.0.0",
|
|
"scripts": {
|
|
"start": "expo start",
|
|
"ios": "expo start --ios",
|
|
"android": "expo start --android",
|
|
"web": "expo start --web",
|
|
"lint": "eslint . --ext .js,.jsx,.ts,.tsx",
|
|
"lint:fix": "eslint . --ext .js,.jsx,.ts,.tsx --fix",
|
|
"type-check": "tsc --noEmit",
|
|
"test": "jest",
|
|
"test:watch": "jest --watch",
|
|
"clean": "rm -rf node_modules ios/Pods ios/build android/build", # Cleans build artifacts only - safe to run
|
|
"clean:metro": "rm -rf $TMPDIR/metro-* $TMPDIR/haste-*", # Cleans Metro bundler cache - safe to run
|
|
"pod-install": "cd ios && pod install && cd ..",
|
|
"prebuild": "expo prebuild --clean",
|
|
"build:ios": "eas build --platform ios"
|
|
},
|
|
"dependencies": {
|
|
"expo": "~50.0.0",
|
|
"react": "18.2.0",
|
|
"react-native": "0.73.0"
|
|
},
|
|
"devDependencies": {
|
|
"@babel/core": "^7.23.0",
|
|
"@types/react": "~18.2.0",
|
|
"@typescript-eslint/eslint-plugin": "^6.0.0",
|
|
"@typescript-eslint/parser": "^6.0.0",
|
|
"eslint": "^8.50.0",
|
|
"eslint-config-expo": "^7.0.0",
|
|
"typescript": "^5.2.0"
|
|
}
|
|
}</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 "Checking React Native iOS setup..."
|
|
|
|
# Node.js version
|
|
echo -n "Node.js: "
|
|
node --version
|
|
|
|
# npm version
|
|
echo -n "npm: "
|
|
npm --version
|
|
|
|
# Watchman
|
|
echo -n "Watchman: "
|
|
watchman --version 2>/dev/null || echo "Not installed"
|
|
|
|
# CocoaPods
|
|
echo -n "CocoaPods: "
|
|
pod --version 2>/dev/null || echo "Not installed"
|
|
|
|
# Xcode
|
|
echo -n "Xcode: "
|
|
xcodebuild -version | head -n1
|
|
|
|
# Command Line Tools
|
|
echo -n "Command Line Tools: "
|
|
xcode-select -p
|
|
|
|
# iOS Simulators
|
|
echo "Available iOS Simulators:"
|
|
xcrun simctl list devices available | grep iPhone
|
|
|
|
# Ruby version
|
|
echo -n "Ruby: "
|
|
ruby --version
|
|
|
|
echo "Setup check complete!"</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 && 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'T: Mix package managers (npm/yarn/pnpm)
|
|
❌ DON'T: Skip pod install after dependency changes
|
|
❌ DON'T: Use outdated Node.js versions
|
|
❌ DON'T: Ignore Xcode update prompts
|
|
❌ DON'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 && 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> |