AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

react-native-best-practices

Provides React Native performance optimization guidelines for FPS, TTI, bundle size, memory leaks, re-renders, and animations. Applies to tasks involving Hermes optimization, JS thread blocking, bridge overhead, FlashList, native modules, or debugging jank and frame drops.

Original source
callstackincubator
License
MIT
Pinned revision
59e9d17446a248b21d86f078fcd0bd2d36db1ca4

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read callstackincubator--react-native-best-practices at revision 59e9d17446a248b21d86f078fcd0bd2d36db1ca4, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 31

references/bundle-analyze-app.md


title: Analyze App Bundle Size impact: HIGH tags: app-size, ruler, emerge-tools, thinning

Skill: Analyze App Bundle Size

Measure iOS and Android app download/install sizes using Ruler, App Store Connect, and Emerge Tools.

Quick Command

# Android (Ruler)
cd android && ./gradlew analyzeReleaseBundle

# iOS (Xcode export with thinning)
cd ios && xcodebuild -exportArchive \
  -archivePath MyApp.xcarchive \
  -exportPath ./export \
  -exportOptionsPlist ExportOptions.plist
# Check: App Thinning Size Report.txt

When to Use

  • App download size is too large
  • Users complain about storage usage
  • App approaching store limits
  • Comparing releases for size regression

Note: This skill involves visual size reports (Ruler, Emerge Tools X-Ray). When regression checks include device flows, use agent-device for app evidence; install it through the environment's approved/trusted path or ask the user if verification needs it and it is missing. Size report analysis itself may still require exported reports, browser screenshots, or human review. Record concrete module/file names and before/after artifact sizes in text when asking an agent to reason about them.

Key Metrics

| Metric | Description | User Impact | |--------|-------------|-------------| | Download Size | Compressed, transferred over network | Download time, data usage | | Install Size | Uncompressed, on device storage | Storage space |

Google finding: Every 6 MB increase reduces installs by 1%.

Android: Ruler (Spotify)

Setup

Add to android/build.gradle:

buildscript {
    dependencies {
        classpath("com.spotify.ruler:ruler-gradle-plugin:2.0.0-beta-3")
    }
}

Add to android/app/build.gradle:

apply plugin: "com.spotify.ruler"

ruler {
    abi.set("arm64-v8a")  // Target architecture
    locale.set("en")
    screenDensity.set(480)
    sdkVersion.set(34)
}

Analyze

cd android
./gradlew analyzeReleaseBundle

Opens HTML report with:

  • Download size
  • Install size
  • Component breakdown (biggest → smallest)

CI Size Validation

ruler {
    verification {
        downloadSizeThreshold = 20 * 1024 * 1024  // 20 MB
        installSizeThreshold = 50 * 1024 * 1024   // 50 MB
    }
}

Build fails if thresholds exceeded.

iOS: Xcode App Thinning

Via App Store Connect (Most Accurate)

After uploading to TestFlight:

  1. Open App Store Connect
  2. Go to your build
  3. View size table by device variant

Note: TestFlight builds include debug data, App Store builds slightly larger due to DRM.

Via Xcode Export

Export an archive with app thinning enabled for all compatible device variants.

Or in ExportOptions.plist:

<key>thinning</key>
<string>&lt;thin-for-all-variants&gt;</string>

Output

Creates folder with:

  • Universal IPA: All variants combined
  • Thinned IPAs: One per device variant
  • App Thinning Size Report.txt:
Variant: SampleApp-<UUID>.ipa
App + On Demand Resources size: 3.5 MB compressed, 10.6 MB uncompressed
App size: 3.5 MB compressed, 10.6 MB uncompressed
  • Compressed = Download size
  • Uncompressed = Install size

Emerge Tools (Cross-Platform)

Third-party service with visual analysis.

Upload

Upload IPA, APK, or AAB through their web interface or CI integration.

Features

Emerge Tools X-Ray for iOS

  • X-Ray: Treemap visualization (like source-map-explorer for binaries)
    • Shows Frameworks (hermes.framework), Mach-O sections (TEXT, DATA), etc.
    • Color-coded: Binaries, Localizations, Fonts, Asset Catalogs, Videos, CoreML Models
    • Visible components: main.jsbundle (JS code), RCT modules, DYLD sections
  • Breakdown: Component-by-component size
  • Insights: Automated suggestions (use with caution)

Caution: Some suggestions may not apply to React Native (e.g., "remove Hermes").

Size Comparison

| Tool | Platform | Accuracy | CI Integration | |------|----------|----------|----------------| | Ruler | Android | High | Yes (Gradle) | | App Store Connect | iOS | Highest | No | | Xcode Export | iOS | High | Yes (xcodebuild) | | Emerge Tools | Both | High | Yes (API) |

Typical React Native App Sizes

| Component | Approximate Size | |-----------|------------------| | Hermes engine | ~2-3 MB | | React Native core | ~3-5 MB | | JavaScript bundle | 1-10 MB | | Assets (images, etc.) | Varies |

Baseline empty app: ~6-10 MB download

Optimization Impact Example

| Optimization | Size Reduction | |--------------|----------------| | Enable R8 (Android) | ~30% | | Remove unused polyfills | 400+ KB | | Asset catalog (iOS) | 10-50% of assets | | Tree shaking | 10-15% |

Quick Commands

# Android release bundle size
cd android && ./gradlew bundleRelease
# Check: android/app/build/outputs/bundle/release/

# iOS archive
cd ios && xcodebuild -workspace ios/MyApp.xcworkspace \
  -scheme MyApp \
  -configuration Release \
  -archivePath MyApp.xcarchive \
  archive

# Export with thinning report
cd ios && xcodebuild -exportArchive \
  -archivePath MyApp.xcarchive \
  -exportPath ./export \
  -exportOptionsPlist ExportOptions.plist

Related Skills