From 6b854421a18cb93a72be2227d7b5ace8c618caa5 Mon Sep 17 00:00:00 2001
From: Fabian-Lars <github@fabianlars.de>
Date: Mon, 10 Nov 2025 21:27:39 +0100
Subject: [PATCH] docs(localhost): improve readme example, closes #3095

---
 plugins/localhost/README.md | 52 ++++++++++++++++++++++++-------------
 1 file changed, 34 insertions(+), 18 deletions(-)

diff --git a/plugins/localhost/README.md b/plugins/localhost/README.md
index dc0d98d2..8ab13b2b 100644
--- a/plugins/localhost/README.md
+++ b/plugins/localhost/README.md
@@ -41,27 +41,43 @@ First you need to register the core plugin with Tauri:
 `src-tauri/src/lib.rs`
 
 ```rust
-use tauri::{Manager, window::WindowBuilder, WindowUrl};
+#[cfg(not(dev))]
+use tauri::{ipc::CapabilityBuilder, Manager, Url};
+use tauri::{WebviewUrl, WebviewWindowBuilder};
 
-fn main() {
-  let port = portpicker::pick_unused_port().expect("failed to find unused port");
+#[cfg_attr(mobile, tauri::mobile_entry_point)]
+pub fn run() {
+    let port = portpicker::pick_unused_port().expect("failed to find unused port");
 
-  tauri::Builder::default()
-    .plugin(tauri_plugin_localhost::Builder::new(port).build())
-    .setup(move |app| {
-      app.ipc_scope().configure_remote_access(
-        RemoteDomainAccessScope::new("localhost")
-          .add_window("main")
-      );
+    tauri::Builder::default()
+        .plugin(tauri_plugin_localhost::Builder::new(port).build())
+        .setup(move |app| {
+            // In `tauri dev` mode you usually use your dev server.
+            #[cfg(dev)]
+            let url = WebviewUrl::App(std::path::PathBuf::from("/"));
 
-      let url = format!("http://localhost:{}", port).parse().unwrap();
-      WindowBuilder::new(app, "main".to_string(), WindowUrl::External(url))
-        .title("Localhost Example")
-        .build()?;
-      Ok(())
-    })
-    .run(tauri::generate_context!())
-    .expect("error while running tauri application");
+            #[cfg(not(dev))]
+            let url = {
+                let url: Url = format!("http://localhost:{}", port).parse().unwrap();
+
+                app.add_capability(
+                    CapabilityBuilder::new("localhost")
+                        .remote(url.to_string())
+                        .window("main"),
+                )?;
+
+                WebviewUrl::External(url)
+            };
+
+            // This requires you to remove the window from tauri.conf.json
+            WebviewWindowBuilder::new(app, "main".to_string(), url)
+                .title("Localhost Example")
+                .build()?;
+
+            Ok(())
+        })
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
 }
 ```