---
title: Troubleshooting
description: Common issues and solutions for Mini development.
source_url:
  html: 'https://shopify.dev/docs/api/shop-minis/troubleshooting'
  md: 'https://shopify.dev/docs/api/shop-minis/troubleshooting.md'
---

# Troubleshooting

Common issues and solutions for Mini development.

***

## Connection 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`

***

## Android 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.

***

## Setting Up

```bash
# Forward the Vite dev server port
adb reverse tcp:5173 tcp:5173
```

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

***