@vaibhavjha/qrfy 1.0.9 → 1.1.0

package/README.md

@@ -125,6 +125,34 @@ Now `npm run dev` gives you a QR code every time. Your whole team gets it for fr
 
 ---
 
+## Share From Anywhere (Cloudflare Tunnel)
+
+Same WiFi not an option? Pass `-t` (or `--tunnel`) and QRfy will expose your dev server through a free [Cloudflare quick tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/do-more-with-tunnels/trycloudflare/) — a fresh `*.trycloudflare.com` URL, reachable over cellular, from a coworker's laptop, or a stakeholder on the other side of the world.
+
+```bash
+qrfy -t next dev
+qrfy --tunnel npm run dev
+```
+
+You'll get a QR for the **public URL** instead of the LAN one. No Cloudflare account needed.
+
+**One-time setup** — install `cloudflared`:
+
+```bash
+# macOS
+brew install cloudflared
+
+# Windows
+winget install --id Cloudflare.cloudflared
+
+# Linux
+# https://pkg.cloudflare.com/index.html
+```
+
+> The tunnel URL is fresh every run and tears down when you Ctrl+C. Don't share it for anything you wouldn't put on the open internet.
+
+---
+
 ## QR for Anything
 
 Need a QR code for a URL, a WiFi password, or any piece of text? Use `-q`:
@@ -143,6 +171,7 @@ No dev server, no port detection — just a scannable QR code in your terminal.
 
 ```bash
 qrfy <command>            # Wrap a dev server
+qrfy -t <command>         # Wrap + expose via Cloudflare tunnel
 qrfy -q <text|url...>     # QR code for any text or URL
 qrfy --help, -h           # Show help
 qrfy --version, -v        # Show version
@@ -189,7 +218,7 @@ qrfy --version, -v        # Show version
 | | Requirement |
 |---|---|
 | **Runtime** | Node.js >= 14 |
-| **Network** | Same WiFi |
+| **Network** | Same WiFi (or `cloudflared` installed for `-t`) |
 | **OS** | macOS, Linux, Windows |
 
 ---
@@ -212,6 +241,13 @@ The port wasn't detected from your server's output. Make sure your dev server pr
 
 </details>
 
+<details>
+<summary><b>"cloudflared is not installed" when using <code>-t</code></b></summary>
+
+Tunnel mode shells out to Cloudflare's `cloudflared` binary. Install it with the command for your OS shown in the [Share From Anywhere](#share-from-anywhere-cloudflare-tunnel) section, then retry.
+
+</details>
+
 <details>
 <summary><b>Command not found after install</b></summary>
 

package/bin/qrfy.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 
 const { getLocalIP } = require("../lib/network");
-const { displayQR, displayStaticQR } = require("../lib/qr");
+const { displayQR, displayStaticQR, displayTunnelQR } = require("../lib/qr");
 const { runServer } = require("../lib/runner");
+const { hasCloudflared, printInstallHint, startTunnel } = require("../lib/tunnel");
 
 const { version } = require("../package.json");
 
@@ -18,17 +19,20 @@ if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
   console.log(`  \x1b[1mqrfy\x1b[0m v${version} - Scan your dev server instantly`);
   console.log("");
   console.log("  \x1b[1mUsage:\x1b[0m");
-  console.log("    qrfy <command> [args...]      Wrap a dev server");
-  console.log("    qrfy -q <text|url...>         QR code for any text or URL");
+  console.log("    qrfy <command> [args...]         Wrap a dev server");
+  console.log("    qrfy -t <command> [args...]      Wrap + expose via Cloudflare tunnel");
+  console.log("    qrfy -q <text|url...>            QR code for any text or URL");
   console.log("");
   console.log("  \x1b[1mExamples:\x1b[0m");
   console.log("    qrfy next dev");
   console.log("    qrfy vite");
   console.log("    qrfy npm run dev");
+  console.log("    qrfy --tunnel next dev");
   console.log("    qrfy -q https://example.com");
   console.log("    qrfy -q \"hello world\"");
   console.log("");
   console.log("  \x1b[1mOptions:\x1b[0m");
+  console.log("    -t, --tunnel     Expose via a Cloudflare quick tunnel (needs cloudflared)");
   console.log("    -q, --qr         Generate QR for any text or URL");
   console.log("    -h, --help       Show this help message");
   console.log("    -v, --version    Show version number");
@@ -47,17 +51,42 @@ if (args[0] === "--qr" || args[0] === "-q") {
   return;
 }
 
-const ip = getLocalIP();
+const tunnel = args.includes("--tunnel") || args.includes("-t");
+const serverArgs = args.filter((a) => a !== "--tunnel" && a !== "-t");
 
-if (!ip) {
-  console.error(
-    "\x1b[31m  QRfy: No network connection found. Connect to WiFi and try again.\x1b[0m"
-  );
+if (serverArgs.length === 0) {
+  console.error("\x1b[31m  QRfy: --tunnel requires a command to wrap (e.g. qrfy -t next dev)\x1b[0m");
   process.exit(1);
 }
 
-runServer(args, (port) => {
-  const localUrl = `http://localhost:${port}`;
-  const mobileUrl = `http://${ip}:${port}`;
-  displayQR(localUrl, mobileUrl);
-});
+if (tunnel) {
+  if (!hasCloudflared()) {
+    printInstallHint();
+    process.exit(1);
+  }
+
+  runServer(serverArgs, (port) => {
+    const tunnelChild = startTunnel(port, (publicUrl) => {
+      displayTunnelQR(publicUrl);
+    });
+
+    process.on("SIGINT", () => tunnelChild.kill("SIGINT"));
+    process.on("SIGTERM", () => tunnelChild.kill("SIGTERM"));
+    process.on("exit", () => tunnelChild.kill("SIGTERM"));
+  });
+} else {
+  const ip = getLocalIP();
+
+  if (!ip) {
+    console.error(
+      "\x1b[31m  QRfy: No network connection found. Connect to WiFi and try again.\x1b[0m"
+    );
+    process.exit(1);
+  }
+
+  runServer(serverArgs, (port) => {
+    const localUrl = `http://localhost:${port}`;
+    const mobileUrl = `http://${ip}:${port}`;
+    displayQR(localUrl, mobileUrl);
+  });
+}

package/lib/qr.js

@@ -23,6 +23,28 @@ function displayQR(localUrl, mobileUrl) {
   });
 }
 
+function displayTunnelQR(publicUrl) {
+  console.log("");
+  console.log("\x1b[1m\x1b[34m  QRfy tunnel ready\x1b[0m");
+  console.log("");
+  console.log(`  Public:  \x1b[32m${publicUrl}\x1b[0m`);
+  console.log("");
+  console.log("  Scan to open from anywhere:");
+  console.log("");
+  qrcode.generate(publicUrl, { small: true }, (code) => {
+    const indented = code
+      .split("\n")
+      .map((line) => "  " + line)
+      .join("\n");
+    console.log(indented);
+    console.log("");
+    console.log(
+      "  \x1b[33mFresh URL per run — reachable over cellular and remote networks\x1b[0m"
+    );
+    console.log("");
+  });
+}
+
 function displayStaticQR(content) {
   console.log("");
   console.log("\x1b[1m\x1b[34m  QRfy\x1b[0m");
@@ -41,4 +63,4 @@ function displayStaticQR(content) {
   });
 }
 
-module.exports = { displayQR, displayStaticQR };
+module.exports = { displayQR, displayStaticQR, displayTunnelQR };

package/lib/tunnel.js

@@ -0,0 +1,53 @@
+const { spawn, spawnSync } = require("child_process");
+
+const TUNNEL_URL_REGEX = /https:\/\/[a-z0-9-]+\.trycloudflare\.com/i;
+
+function hasCloudflared() {
+  const probe = spawnSync(
+    process.platform === "win32" ? "where" : "which",
+    ["cloudflared"],
+    { stdio: "ignore" }
+  );
+  return probe.status === 0;
+}
+
+function printInstallHint() {
+  console.error("");
+  console.error("\x1b[31m  QRfy: cloudflared is not installed.\x1b[0m");
+  console.error("");
+  console.error("  Install it, then re-run with --tunnel:");
+  console.error("    macOS:    \x1b[36mbrew install cloudflared\x1b[0m");
+  console.error("    Windows:  \x1b[36mwinget install --id Cloudflare.cloudflared\x1b[0m");
+  console.error("    Linux:    \x1b[36mhttps://pkg.cloudflare.com/index.html\x1b[0m");
+  console.error("");
+}
+
+function startTunnel(port, onUrl) {
+  const child = spawn(
+    "cloudflared",
+    ["tunnel", "--no-autoupdate", "--url", `http://localhost:${port}`],
+    { stdio: ["ignore", "pipe", "pipe"] }
+  );
+
+  let resolved = false;
+
+  function scan(buf) {
+    if (resolved) return;
+    const match = buf.toString().match(TUNNEL_URL_REGEX);
+    if (match) {
+      resolved = true;
+      onUrl(match[0]);
+    }
+  }
+
+  child.stdout.on("data", scan);
+  child.stderr.on("data", scan);
+
+  child.on("error", (err) => {
+    console.error(`\x1b[31m  QRfy tunnel error: ${err.message}\x1b[0m`);
+  });
+
+  return child;
+}
+
+module.exports = { hasCloudflared, printInstallHint, startTunnel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaibhavjha/qrfy",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "Scan your dev server instantly - QR code for local dev URLs",
   "author": "Vaibhav Jha (https://github.com/vaibhavjha-dev)",
   "repository": {