twofourlabs/agent-docs

Overview

This skill provides a focused migration assistant to upgrade React Native projects from 0.79.x to 0.83.x. It automates detection of known breaking-change patterns, offers concrete code fixes for Android native modules and MMKV storage, and supplies exact dependency and build commands. Use it to reduce manual effort and validate a clean upgrade across Android and iOS.

How this skill works

The skill scans project files for patterns introduced by 0.79→0.83 changes (currentActivity usage, nullable Intent handlers, MMKV API calls, MainApplication.kt layouts). It produces a checklist, applies safe replacements (with import and type fixes), and emits exact npm commands for dependency updates. Finally it runs cleanup and validation steps to confirm build and runtime stability.

When to use it

• Upgrading a project from React Native 0.79.x to 0.83.x
• After encountering build or runtime errors post-upgrade
• When Android native modules reference currentActivity or onNewIntent(Intent?)
• When migrating MMKV storage usages to the new API
• Before releasing to ensure no deprecated RN patterns remain

Best practices

• Run a full git branch and create a migration checklist before changes
• Upgrade Node.js to v20+ before installing RN 0.83 dependencies
• Search and replace patterns in dedicated commits per change type (native modules, MMKV, MainApplication.kt)
• Add missing imports and explicit type annotations when fixing Kotlin code
• Perform clean installs and full Android/iOS clean builds and reset Metro cache

Example use cases

• Detect and replace all occurrences of currentActivity → reactApplicationContext.currentActivity in native modules
• Refactor MainApplication.kt to use lazy reactHost and loadReactNative(this) template
• Replace MMKV usage: new MMKV → createMMKV and storage.delete → storage.remove
• Run exact npm install commands for verified dependency versions and dev tooling
• Execute build-clean commands and validate with grep checks for residual patterns