From 723ef41aa28d958739a56b389eec40558a07ec3a Mon Sep 17 00:00:00 2001 From: sumeyye Date: Wed, 10 Jun 2026 09:19:13 +0300 Subject: [PATCH] update: docs to guide user for clodflare tunnel insrall --- docs/en/framework/ui/react-native/index.md | 2 ++ docs/en/framework/ui/react-native/running-on-device.md | 9 ++++++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/docs/en/framework/ui/react-native/index.md b/docs/en/framework/ui/react-native/index.md index a1a52d9f81..def2ac125c 100644 --- a/docs/en/framework/ui/react-native/index.md +++ b/docs/en/framework/ui/react-native/index.md @@ -78,6 +78,8 @@ You can choose how you want to run the mobile app: | **Browser testing (fastest)** | [Running on Web](./running-on-web.md) — ABP Studio **Default** profile or Expo Web + HTTPS proxy at `https://localhost:8443` | | **Emulator, simulator, or physical device** | [Running on Device](./running-on-device.md) — **Pro, non-tiered Monolith:** **MobileEmulator** profile or `yarn tunnel:api`; **Tiered / Microservice:** manual backend setup | +> **Before device testing (Monolith):** Install **cloudflared** using Cloudflare's [Download and install cloudflared](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/downloads/) guide. The template's Quick Tunnel workflow does not require a Cloudflare account or the remaining steps in that document. + Before running, you may need to install dependencies in the React Native project folder: - **Monolith / Tiered / app-nolayers:** `react-native/` diff --git a/docs/en/framework/ui/react-native/running-on-device.md b/docs/en/framework/ui/react-native/running-on-device.md index ab1b70f271..0b45f7a4a4 100644 --- a/docs/en/framework/ui/react-native/running-on-device.md +++ b/docs/en/framework/ui/react-native/running-on-device.md @@ -53,7 +53,7 @@ For browser testing, see [Running on Web](./running-on-web.md). {{ if Architecture == "Monolith" }} -4. Install [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/) for the built-in Cloudflare tunnel (`yarn tunnel:api`). Quick Tunnels are free and do not require a Cloudflare account. +1. Install **cloudflared** before using the **MobileEmulator** profile or `yarn tunnel:api`. Follow Cloudflare's [Download and install cloudflared](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/downloads/) guide. The template uses free Quick Tunnels (`*.trycloudflare.com`) and does not require a Cloudflare account or the remaining locally-managed tunnel steps in that document. {{ end }} @@ -71,8 +71,9 @@ For browser testing, see [Running on Web](./running-on-web.md). Before the first run: -1. Switch to the **MobileEmulator** profile in the Solution Runner. -2. Open `react-native/Environment.ts` and follow the inline comments: **uncomment the tunnel configuration block** and **comment out the localhost constants**. +1. [Install cloudflared](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/downloads/) if you have not already (see [Prerequisites](#prerequisites)). +2. Switch to the **MobileEmulator** profile in the Solution Runner. +3. Open `react-native/Environment.ts` and follow the inline comments: **uncomment the tunnel configuration block** and **comment out the localhost constants**. Start an Android emulator (or connect a device), then start the **MobileEmulator** profile. @@ -96,6 +97,8 @@ See [Cloudflare tunnel (manual CLI)](#cloudflare-tunnel-manual-cli) below for wh Non-tiered React Native templates ship with a Cloudflare tunnel automation script. The tunnel gives your mobile app a temporary **HTTPS** URL (for example `https://example.trycloudflare.com`) that forwards to your local backend — without reconfiguring Kestrel or OpenIddict over HTTP. +> **Prerequisite:** Install **cloudflared** on your machine using Cloudflare's [Download and install cloudflared](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/downloads/) guide before running `yarn tunnel:api` or the **MobileEmulator** profile. + The template includes: | Item | Location |