Troubleshooting

Common issues and solutions for Mini development.

Anchor to Connection issuesConnection issues

If you're having connection issues or your Mini isn't loading:

• For WiFi: Verify devices are on the same network segment
• Check firewall settings aren't blocking port 5173
• Try using your computer's IP directly: npx shop-minis dev --host 192.168.1.100

Anchor to Android Port ForwardingAndroid Port Forwarding

In some cases your Android device might not be able to connect to the Mini's dev server. Port forwarding creates a tunnel between your Android device and development machine, allowing the Shop app to access your Mini.

Anchor to Setting UpSetting Up

This maps port 5173 on the Android device to port 5173 on your development machine.