@vaibhavjha/qrfy 1.0.7 → 1.0.9

package/README.md

@@ -20,11 +20,11 @@ Stop typing IPs. Start scanning.
 ## Quick Start
 
 ```bash
-# Install globally
-npm install -g @vaibhavjha/qrfy
+# Install as a dev dependency
+npm install -D @vaibhavjha/qrfy
 
 # Run with your dev server
-qrfy next dev
+npx qrfy next dev
 ```
 
 That's it. A QR code appears in your terminal. Scan it. Done.
@@ -60,13 +60,26 @@ $ qrfy next dev
 ## Install
 
 ```bash
-npm install -g @vaibhavjha/qrfy
+# As a dev dependency
+npm install -D @vaibhavjha/qrfy
 ```
 
 <details>
 <summary><b>yarn / pnpm / bun</b></summary>
 
 ```bash
+yarn add -D @vaibhavjha/qrfy
+pnpm add -D @vaibhavjha/qrfy
+bun add -d @vaibhavjha/qrfy
+```
+
+</details>
+
+<details>
+<summary><b>Install globally (optional)</b></summary>
+
+```bash
+npm install -g @vaibhavjha/qrfy
 yarn global add @vaibhavjha/qrfy
 pnpm add -g @vaibhavjha/qrfy
 bun add -g @vaibhavjha/qrfy
@@ -112,12 +125,27 @@ Now `npm run dev` gives you a QR code every time. Your whole team gets it for fr
 
 ---
 
+## 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 -q <text|url...>     # QR code for any text or URL
+qrfy --help, -h           # Show help
+qrfy --version, -v        # Show version
 ```
 
 ---
@@ -161,7 +189,7 @@ qrfy --version, -v   # Show version
 | | Requirement |
 |---|---|
 | **Runtime** | Node.js >= 14 |
-| **Network** | Both devices on the same WiFi |
+| **Network** | Same WiFi |
 | **OS** | macOS, Linux, Windows |
 
 ---

package/bin/qrfy.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 const { getLocalIP } = require("../lib/network");
-const { displayQR } = require("../lib/qr");
+const { displayQR, displayStaticQR } = require("../lib/qr");
 const { runServer } = require("../lib/runner");
 
 const { version } = require("../package.json");
@@ -18,20 +18,35 @@ 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 -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 -q https://example.com");
+  console.log("    qrfy -q \"hello world\"");
   console.log("");
   console.log("  \x1b[1mOptions:\x1b[0m");
+  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);
 }
 
+// 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 ip = getLocalIP();
 
 if (!ip) {

package/lib/qr.js

@@ -23,4 +23,22 @@ function displayQR(localUrl, mobileUrl) {
   });
 }
 
-module.exports = { displayQR };
+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 };

package/package.json

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