tauri-apps / tauri-apps/tauri-docs

document that iOS and macos devices must be on the same local network for development.

Open
#3,362 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
MDX
Stars
1.1k
Forks
887
Avg merge
2d 8h
Merged PRs (30d)
48

Description

Describe the bug

If you run the application in the Xcode Simulator - pnpm tauri ios dev "iPhone 16 Pro", then everything works fine.
But when connecting a physical iPhone by wire and launching pnpm tauri ios dev, the application is successfully builded and installed, but when opened, only a black screen is displayed and nothing more.
After a while, the message "error sending request" appears.

Image

Reproduction
  1. Install a clean Tauri Vue.js application.
  2. Launch the application in Xcode Simulator, make sure that everything is working well.
  3. Set up all sorts of crap like Apple Team ID, certificate, etc.
  4. Run tauri ios dev on a physical iPhone.
Expected behavior

The app will be displayed on the phone.

Full tauri info output
[✔] Environment
    - OS: Mac OS 15.4.1 arm64 (X64)
    ✔ Xcode Command Line Tools: installed
    ✔ rustc: 1.87.0 (17067e9ac 2025-05-09)
    ✔ cargo: 1.87.0 (99624be96 2025-05-06)
    ✔ rustup: 1.28.2 (e4f3ad6f8 2025-04-28)
    ✔ Rust toolchain: stable-aarch64-apple-darwin (default)
    - node: 24.2.0
    - pnpm: 10.10.0
    - npm: 11.3.0

[-] Packages
    - tauri 🦀: 2.5.1
    - tauri-build 🦀: 2.2.0
    - wry 🦀: 0.51.2
    - tao 🦀: 0.33.0
    - @tauri-apps/api : 2.5.0
    - @tauri-apps/cli : 2.5.0

[-] Plugins
    - tauri-plugin-opener 🦀: 2.3.0
    - @tauri-apps/plugin-opener : 2.3.0

[-] App
    - build-type: bundle
    - CSP: unset
    - frontendDist: ../dist
    - devUrl: http://localhost:1420/
    - framework: Vue.js
    - bundler: Vite

[-] iOS
    - Developer Teams: *****
Stack trace

Additional context

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the iOS development documentation and the pnpm tauri ios dev entry point, focusing on physical iPhone setup rather than the Xcode Simulator. Verify the reported behavior on a wired device, then document that the iOS and macOS devices must share a local network and explain the resulting connection failure.

Written by the indexing model from the issue text.

Assessment

Tech stack
ios, macos
Domain
documentation, mobile-dev
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.