Observed Symptoms & Error Messages
Users encountering this problem typically observe one or more of the following behaviors when running AirCard on macOS:
- The customized card artwork appears perfectly in the Apple Wallet app on the iPhone.
- Opening Apple Wallet on the paired Apple Watch continues to display the default card skin or generic placeholder.
- Re-syncing with AirCard confirms success on the iPhone, but the Apple Watch image remains unchanged.
Confirmed Technical Context
Analyzed in GitHub Issue #118 across watchOS 9, watchOS 10, and watchOS 11 paired with iOS 16 through iOS 18. This is a fundamental characteristic of watchOS distributed pass caching.
Step-by-Step Diagnostic Checklist
Work through the following checklist in sequence. Each step is designed to be safe, reversible, and targeted toward identifying the exact point of communication failure:
Understand the watchOS PassKit Cache Architecture
Safe & ReversibleRecognize that watchOS does not stream pass visuals in real time from your iPhone over Bluetooth. Passes are stored locally in the Apple Watch flash storage to enable offline tap-to-pay and badge scanning. Modifying files on the iPhone does not trigger an automatic asset re-distribution to the Watch.
Trigger a Manual Pass Invalidation in the Watch App
Safe & ReversibleOn your iPhone, open the "Watch" app. Tap "Wallet & Apple Pay". Tap the card you updated with AirCard. Toggle a non-sensitive setting (such as turning "Allow Notifications" off and then back on). This forces the Watch app to send a synchronization signal to the Watch.
Restart Both iPhone and Apple Watch
Safe & ReversiblePower off your Apple Watch (hold the side button and slide Power Off). Power off your iPhone. Power on your iPhone first, wait for it to reach the Home Screen, and then power on your Apple Watch. Allow 5 minutes for Bluetooth and Wi-Fi sync queues to settle.
Re-add Pass if Watch Support is Mandatory
Safe & ReversibleFor loyalty or membership passes that support it, you can remove the pass from the Watch app (Watch app > Wallet & Apple Pay > select card > Remove) and re-enable it from the "Cards on your phone" section.
What the Upstream GitHub Issue Confirms
Issue #118 confirms that AirCard cannot connect directly to an Apple Watch over USB (as the Watch does not feature a consumer USB data interface). All Watch updates rely entirely on Apple's proprietary WatchKit background sync mechanism, which prioritizes battery conservation and aggressive image caching.
If the Issue Persists
For payment cards (Apple Card, bank cards), Apple Watch requires individual tokenization and signs the pass assets with Watch-specific cryptographic keys. In many cases, watchOS will enforce official issuer graphics on payment cards.
If you have exhausted all steps without success, you can gather non-sensitive macOS Console diagnostic messages (filter by process name usbmuxd or AirCard) and contribute your findings to the upstream issue tracker at Issue #118 on GitHub.
Technical Evidence & Verification
âś“ Verified SourceThis document adheres to the AirCardGuide factual verification policy. Conclusions, system requirements, and diagnostic procedures are confirmed against official upstream releases and technical issue discussions.