feat: react-native support

docs/guides/cli/connect-devices-to-local-nhost-project.mdx

@@ -0,0 +1,121 @@
+---
+title: Connect Devices to Local Nhost Project
+description: Configuring dnsmasq for network device connectivity to a local Nhost project
+icon: ethernet
+---
+
+## Introduction
+
+If you want to connect to your local environment from other devices on the same network, such as Android emulators
+or iPhone devices, you can use **dnsmasq**. Follow this guide for the necessary configuration steps to enable this
+functionality for your local Nhost project running on your machine.
+
+<Note>
+ Make sure to install **dnsmasq**. If you're using another OS, please refer to the [dnsmasq website](https://thekelleys.org.uk/dnsmasq/doc.html).
+
+ <Tabs>
+ <Tab title="macOS">
+ ```shell Terminal
+ brew install dnsmasq
+ ```
+ </Tab>
+ <Tab title="Debian">
+ ```shell Terminal
+ apt-get install dnsmasq
+ ```
+ </Tab>
+ <Tab title="Nix">
+ ```shell Terminal
+ nix-env -iA nixpkgs.dnsmasq
+ ```
+ </Tab>
+ </Tabs>
+</Note>
+
+# Configure dnsmasq for Android
+<Warning>These steps are necessary when running on both an **Android emulator** or **physical Android device**</Warning>
+<Steps>
+ <Step title="Configure dnsmasq">
+ Configure `dnsmasq` to resolve nhost service urls to your machine's special [loopback address](https://developer.android.com/studio/run/emulator-networking) `10.0.2.2`
+ ```shell Terminal
+ sudo dnsmasq -d \
+ --address=/local.auth.nhost.run/10.0.2.2 \
+ --address=/local.graphql.nhost.run/10.0.2.2 \
+ --address=/local.storage.nhost.run/10.0.2.2 \
+ --address=/local.functions.nhost.run/10.0.2.2 
+ ```
+ </Step>
+ <Step title="Restart dnsmasq">
+ If you're using another OS, please refer to the [dnsmasq website](https://thekelleys.org.uk/dnsmasq/doc.html).
+ <Tabs>
+ <Tab title="macOS">
+ ```shell Terminal
+ sudo brew services restart dnsmasq
+ ```
+ </Tab>
+ <Tab title="Debian">
+ ```shell Terminal
+ sudo systemctl restart dnsmasq
+ ```
+ </Tab>
+ </Tabs>
+ </Step>
+ <Step title="Configure the android device/emulator's DNS settings">
+ 1. Edit your network settings: Settings > Network & Internet > Internet > AndroidWifi
+ 2. set `IP settings` to `Static`
+ 3. set `DNS 1` and `DNS 2` to `10.0.2.2`
+ 4. Save
+ </Step>
+</Steps>
+
+# Configure dnsmasq for iOS
+<Warning>These steps are only necessary when running on physical iOS device, the iOS simulator uses the host machine's network, so no additional configuration is typically needed.</Warning>
+<Steps>
+ <Step title="Inspect your machine's IP address on your network">
+ <Tabs>
+ <Tab title="macOS">
+ ```shell Terminal
+ ipconfig getifaddr en0
+ ```
+ </Tab>
+ <Tab title="Debian">
+ ```shell Terminal
+ ip addr show dev en0 | grep 'inet ' | awk '{print $2}' | cut -d/ -f1
+ ```
+ </Tab>
+ </Tabs>
+ </Step>
+ <Step title="Configure dnsmasq">
+ Configure `dnsmasq` to resolve nhost service urls to your machine's ip address.
+ <Warning>Make sure to replace every occurrence of **[your-machine-s-up-address]** with the address printed in Step `1`</Warning>
+
+ ```shell Terminal
+ sudo dnsmasq -d \
+ --address=/local.auth.nhost.run/[your-machine-s-up-address] \
+ --address=/local.graphql.nhost.run/[your-machine-s-up-address] \
+ --address=/local.storage.nhost.run/[your-machine-s-up-address] \
+ --address=/local.functions.nhost.run/[your-machine-s-up-address]
+ ```
+ </Step>
+ <Step title="Restart dnsmasq">
+ If you're using another OS, please refer to the [dnsmasq website](https://thekelleys.org.uk/dnsmasq/doc.html).
+ <Tabs>
+ <Tab title="macOS">
+ ```shell Terminal
+ sudo brew services restart dnsmasq
+ ```
+ </Tab>
+ <Tab title="Debian">
+ ```shell Terminal
+ sudo systemctl restart dnsmasq
+ ```
+ </Tab>
+ </Tabs>
+ </Step>
+ <Step title="Configure the iPhone's DNS settings">
+ 1. Select the wifi you're connected and select `Configure DNS`
+ 2. Select `Manual`
+ 3. Click on `Add server` and type your local machine's IP address printed in Step `1`
+ 4. Save
+ </Step>
+</Steps>