@vaibhavjha/qrfy 1.0.8 → 1.1.0

package/README.md

@@ -125,12 +125,56 @@ 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`:
+
+```bash
+qrfy -q https://example.com
+qrfy -q "hello world"
+qrfy -q "WIFI:T:WPA;S:MyNetwork;P:mypassword;;"
+```
+
+No dev server, no port detection — just a scannable QR code in your terminal.
+
+---
+
 ## CLI Options
 
 ```bash
-qrfy <command>       # Wrap a dev server
-qrfy --help, -h      # Show help
-qrfy --version, -v   # Show version
+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
 ```
 
 ---
@@ -174,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 |
 
 ---
@@ -197,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 } = 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,31 +19,74 @@ 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...]");
+  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");
   console.log("");
   process.exit(0);
 }
 
-const ip = getLocalIP();
+// Static QR: explicit QR mode
+if (args[0] === "--qr" || args[0] === "-q") {
+  const content = args.slice(1).join(" ");
+  if (!content) {
+    console.error("\x1b[31m  QRfy: -q requires content\x1b[0m");
+    process.exit(1);
+  }
+  displayStaticQR(content);
+  return;
+}
+
+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,4 +23,44 @@ function displayQR(localUrl, mobileUrl) {
   });
 }
 
-module.exports = { displayQR };
+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");
+  console.log("");
+  console.log(`  Content: \x1b[32m${content}\x1b[0m`);
+  console.log("");
+  console.log("  Scan with your phone:");
+  console.log("");
+  qrcode.generate(content, { small: true }, (code) => {
+    const indented = code
+      .split("\n")
+      .map((line) => "  " + line)
+      .join("\n");
+    console.log(indented);
+    console.log("");
+  });
+}
+
+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.8",
+  "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": {