// 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
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
FIX 1Join the same Wi-Fi
- 01Put both on the same non-guest network
- 02Disable VPN on both
Did this fix it?FIX 2Allow local network access
- 01iPhone Settings > Privacy & Security > Local Network
- 02Enable Principle Mirror
Did this fix it?FIX 3Connect by USB
- 01Plug in the iPhone, tap Trust
- 02Pick the device in Principle Mirror menu
Did this fix it?FIX 4Update both apps
- 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