@vaibhavjha/qrfy 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vaibhav Jha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# QRfy
+
+**Scan your dev server instantly.**
+
+QRfy wraps any dev server command and generates a QR code in your terminal so you can open it on your phone in seconds. No more typing `192.168.x.x:3000` manually.
+
+[![npm version](https://img.shields.io/npm/v/qrfy.svg)](https://www.npmjs.com/package/qrfy)
+[![license](https://img.shields.io/npm/l/qrfy.svg)](https://github.com/vaibhavjha-dev/qrfy/blob/main/LICENSE)
+
+---
+
+## Install
+
+```bash
+npm install -g qrfy
+```
+
+Or with other package managers:
+
+```bash
+# yarn
+yarn global add qrfy
+
+# pnpm
+pnpm add -g qrfy
+
+# bun
+bun add -g qrfy
+```
+
+## Usage
+
+```bash
+qrfy <your-dev-command>
+```
+
+### Examples
+
+```bash
+# Next.js
+qrfy next dev
+
+# Vite
+qrfy vite
+
+# npm scripts
+qrfy npm run dev
+
+# Any server
+qrfy python -m http.server 8000
+```
+
+### Output
+
+```
+  QRfy connected
+
+  Local:   http://localhost:3000
+  Mobile:  http://192.168.1.5:3000
+
+  Scan to open on your phone:
+
+  [QR CODE]
+
+  Ensure both devices are on the same WiFi
+```
+
+## How It Works
+
+1. Spawns your dev command as a child process
+2. Watches stdout/stderr for a port number
+3. Detects your LAN IP address
+4. Generates a terminal QR code pointing to `http://<your-ip>:<port>`
+
+Your dev server output is passed through normally — QRfy just adds the QR code on top.
+
+## Package.json Integration
+
+```json
+{
+  "scripts": {
+    "dev": "qrfy next dev"
+  }
+}
+```
+
+Then just `npm run dev` and scan.
+
+## Supported Frameworks
+
+Works with anything that prints a URL or port to the terminal:
+
+- Next.js
+- Vite
+- Create React App
+- Remix
+- Astro
+- SvelteKit
+- Express / Fastify / any Node server
+- Python / Go / Ruby servers
+- Anything else
+
+## Requirements
+
+- Node.js >= 14
+- Both devices on the same WiFi network
+
+## License
+
+MIT

package/bin/qrfy.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+const { getLocalIP } = require("../lib/network");
+const { displayQR } = require("../lib/qr");
+const { runServer } = require("../lib/runner");
+
+const args = process.argv.slice(2);
+
+if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+  console.log("");
+  console.log("  \x1b[1mqrfy\x1b[0m - Scan your dev server instantly");
+  console.log("");
+  console.log("  \x1b[1mUsage:\x1b[0m");
+  console.log("    qrfy <command> [args...]");
+  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("");
+  process.exit(0);
+}
+
+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(args, (port) => {
+  const localUrl = `http://localhost:${port}`;
+  const mobileUrl = `http://${ip}:${port}`;
+  displayQR(localUrl, mobileUrl);
+});

package/lib/network.js

@@ -0,0 +1,15 @@
+const os = require("os");
+
+function getLocalIP() {
+  const interfaces = os.networkInterfaces();
+  for (const name of Object.keys(interfaces)) {
+    for (const iface of interfaces[name]) {
+      if (iface.family === "IPv4" && !iface.internal) {
+        return iface.address;
+      }
+    }
+  }
+  return null;
+}
+
+module.exports = { getLocalIP };

package/lib/parser.js

@@ -0,0 +1,23 @@
+const PORT_PATTERNS = [
+  /https?:\/\/localhost:(\d+)/,
+  /https?:\/\/127\.0\.0\.1:(\d+)/,
+  /https?:\/\/0\.0\.0\.0:(\d+)/,
+  /https?:\/\/\[::\]:(\d+)/,
+  /port\s+(\d+)/i,
+  /:(\d{4,5})\b/,
+];
+
+function extractPort(text) {
+  for (const pattern of PORT_PATTERNS) {
+    const match = text.match(pattern);
+    if (match) {
+      const port = parseInt(match[1], 10);
+      if (port > 0 && port <= 65535) {
+        return port;
+      }
+    }
+  }
+  return null;
+}
+
+module.exports = { extractPort };

package/lib/qr.js

@@ -0,0 +1,26 @@
+const qrcode = require("qrcode-terminal");
+
+function displayQR(localUrl, mobileUrl) {
+  console.log("");
+  console.log("\x1b[1m\x1b[32m  QRfy connected\x1b[0m");
+  console.log("");
+  console.log(`  Local:   \x1b[36m${localUrl}\x1b[0m`);
+  console.log(`  Mobile:  \x1b[36m${mobileUrl}\x1b[0m`);
+  console.log("");
+  console.log("  Scan to open on your phone:");
+  console.log("");
+  qrcode.generate(mobileUrl, { small: true }, (code) => {
+    const indented = code
+      .split("\n")
+      .map((line) => "  " + line)
+      .join("\n");
+    console.log(indented);
+    console.log("");
+    console.log(
+      "  \x1b[33mEnsure both devices are on the same WiFi\x1b[0m"
+    );
+    console.log("");
+  });
+}
+
+module.exports = { displayQR };

package/lib/runner.js

@@ -0,0 +1,56 @@
+const { spawn } = require("child_process");
+const { extractPort } = require("./parser");
+
+function runServer(args, onPort) {
+  const child = spawn(args.join(" "), [], {
+    stdio: ["inherit", "pipe", "pipe"],
+    shell: true,
+    env: { ...process.env },
+  });
+
+  let detected = false;
+
+  function handleData(data) {
+    const text = data.toString();
+    process.stdout.write(text);
+
+    if (!detected) {
+      const port = extractPort(text);
+      if (port) {
+        detected = true;
+        onPort(port);
+      }
+    }
+  }
+
+  child.stdout.on("data", handleData);
+  child.stderr.on("data", (data) => {
+    const text = data.toString();
+    process.stderr.write(text);
+
+    if (!detected) {
+      const port = extractPort(text);
+      if (port) {
+        detected = true;
+        onPort(port);
+      }
+    }
+  });
+
+  child.on("error", (err) => {
+    console.error(`\x1b[31m  QRfy error: ${err.message}\x1b[0m`);
+    process.exit(1);
+  });
+
+  child.on("close", (code) => {
+    process.exit(code ?? 0);
+  });
+
+  // Forward signals to child
+  process.on("SIGINT", () => child.kill("SIGINT"));
+  process.on("SIGTERM", () => child.kill("SIGTERM"));
+
+  return child;
+}
+
+module.exports = { runServer };

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@vaibhavjha/qrfy",
+  "version": "1.0.0",
+  "description": "Scan your dev server instantly - QR code for local dev URLs",
+  "author": "Vaibhav Jha (https://github.com/vaibhavjha-dev)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vaibhavjha-dev/qrfy.git"
+  },
+  "homepage": "https://github.com/vaibhavjha-dev/qrfy#readme",
+  "bugs": {
+    "url": "https://github.com/vaibhavjha-dev/qrfy/issues"
+  },
+  "bin": {
+    "qrfy": "./bin/qrfy.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "qr",
+    "qrcode",
+    "dev-server",
+    "mobile",
+    "localhost",
+    "cli",
+    "developer-tools",
+    "vite",
+    "nextjs",
+    "react"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=14"
+  },
+  "dependencies": {
+    "qrcode-terminal": "^0.12.0"
+  }
+}