// troubleshooting guide · principle

Principle Mirror Not Connecting to iPhone

Status
Workaround available
platforms:
macOS, iOS
updated:
November 15, 2026
reports:
3
Method
how we research
Share

RUNBOOK · principle/mirror-not-connecting4 FIXES

// quick answer

Principle Mirror fails to show your prototype on the iPhone when Mac and phone are on different networks, USB trust is missing or the app versions differ. Use the same Wi-Fi or a USB cable.

Most likely fix: Join the same Wi-Fi

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Join the same Wi-Fi

    1. 01Put both on the same non-guest network
    2. 02Disable VPN on both
    Did this fix it?
  2. FIX 2Allow local network access

    1. 01iPhone Settings > Privacy & Security > Local Network
    2. 02Enable Principle Mirror
    Did this fix it?
  3. FIX 3Connect by USB

    1. 01Plug in the iPhone, tap Trust
    2. 02Pick the device in Principle Mirror menu
    Did this fix it?
  4. FIX 4Update both apps

    1. 01Update Principle on the Mac and Mirror from the App Store
    Did this fix it?

Symptoms

Mirror app on iPhone shows no Mac, prototype does not load, or it disconnects.

Why it happens

  • C-01Mac and iPhone on different Wi-Fi networks or guest network with client isolation
  • C-02Lightning/USB cable not trusted
  • C-03Outdated Principle Mirror app
  • C-04Local network permission denied on iOS

// this guide also covers

  • principle mirror not connecting
  • principle mirror iphone not working
  • principle mirror usb

Still not working?

If Principle keeps failing, you're not alone. See every Principle problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch Principle Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Principle errors