Skip to main content

Mobile Component Migration

The abyss-v2-migration-mobile skill migrates React Native code that consumes @uhg-abyss/mobile from v1 to v2, including import normalization, prop updates, and verification.

Recommended model: Claude Sonnet 4.6 or higher.

What it does​

This skill handles mobile component migration by:

  • Detecting mobile package version and setting correct import strategy
  • Normalizing import patterns (V2Component as Component for v1.x.x, canonical names for v2.x.x)
  • Updating props and APIs for mobile v2 compatibility
  • Handling mobile-specific changes (Button, Banner, SelectInput, etc.)
  • Detecting and updating wrapper components
  • Updating test files to match migrated components

When to use it​

Use this skill when:

  • Migrating React Native applications from Abyss v1 to v2
  • Normalizing legacy V2-prefixed import patterns in 2.x.x
  • Updating wrapper components that re-export Abyss mobile

Note: This skill is automatically invoked by the abyss-v2-migration orchestrator.

Prerequisites​

  • @uhg-abyss/mobile v1.x.x or v2.x.x

The skill auto-detects your package version and adjusts the migration strategy accordingly. If you're on v1.x.x, the skill will check if you're on the latest v1 version and recommend upgrading to ensure all V2 components are available.

  • Before installing this skill, ensure you have the Abyss CLI set up properly:
npx @uhg-abyss/cli -v

If the command fails, refer to the CLI Setup Guide for installation instructions.

Installation​

Install the skill:

npx @uhg-abyss/cli skills add abyss-v2-migration-mobile

Example prompts​

Once installed, you can use prompts like:

  • "Migrate the mobile components in ./src to Abyss v2"
  • "Update my Abyss mobile components to v2"
  • "Normalize the V2 prefix imports in my React Native app"

Additional v2.x.x steps​

This skill handles component migrations only. Once v2.x.x is installed you must also manually upgrade React 18+, React Native 0.70+, update theming, and handle Toast breaking changes. See the complete mobile migration guide.

More information​

Table of Contents