Skip to content
Legato Docs

How to troubleshoot host and parity validation

Prerequisites

Section titled “Prerequisites”
  • Access to the host app used for validation.
  • Access to parity/evidence docs under packages/react-native/docs/.

Steps

Section titled “Steps”
  1. Verify host mode first.

If validation was run in Expo Go, rerun with:

Terminal window
npx expo prebuild --clean
npx expo run:ios
npx expo run:android
  1. Verify plugin registration.

Ensure Expo config includes:

{
  "expo": {
    "plugins": ["@ddgutierrezc/legato-react-native"]
  }
}
  1. Validate Android service shape.

Confirm one expo.modules.legato.LegatoPlaybackService declaration with:

  • android:exported="false"
  • android:foregroundServiceType="mediaPlayback"
  1. Resolve duplicated manual Android service edits.

Follow the manual conflict steps in packages/react-native/docs/milestone-1-readiness-checklist.md and regenerate native projects.

  1. Re-check parity evidence completeness.

Confirm all required entries in:

  • packages/react-native/docs/evidence/parity-readiness-checklist.md
  • packages/react-native/docs/evidence/phase4-3-expo-host-validation-2026-05-02.md

Expected Result

Section titled “Expected Result”

Validation is executed in supported hosts, plugin baseline wiring is aligned with source contracts, and parity claim status can be evaluated from complete evidence artifacts.