devtunnel-cli 3.0.9 → 3.0.11

package/README.md

@@ -13,12 +13,33 @@
 
 ## ⚡ Quick Start
 
-### Option 1: Install via npm (Recommended)
+### Step-by-Step Guide
+
+**1. Install DevTunnel (one-time setup):**
 ```bash
 npm install -g devtunnel-cli
-devtunnel
 ```
 
+**2. Navigate to your project directory:**
+```bash
+cd your-project
+```
+
+**3. Start your dev server (in one terminal):**
+```bash
+npm start
+# OR
+npm run dev
+```
+
+**4. Run DevTunnel (in another terminal, same directory):**
+```bash
+cd your-project  # Same directory where you run npm start
+devtunnel        # Auto-detects project and port!
+```
+
+**That's it!** DevTunnel will automatically detect your project and running dev server port.
+
 ### Option 2: Download from GitHub
 
 **Windows:**
@@ -54,13 +75,27 @@ npm start
 
 ## 💡 How to Use
 
-1. Start your dev server: `npm start` or `npm run dev` (whichever your project uses)
-2. Run DevTunnel (see Quick Start above)
-3. Select your project folder
-4. Enter your port (default: 5173 for Vite, 3000 for most others)
-5. Get your public URL and share it! 🌍
+**Important:** Run `devtunnel` from the same directory where you run `npm start` or `npm run dev`!
+
+1. **Install DevTunnel** (one-time): `npm install -g devtunnel-cli`
+2. **Go to your project**: `cd your-project`
+3. **Start your dev server**: `npm start` or `npm run dev` (keep this running)
+4. **Open a new terminal** in the same project directory
+5. **Run DevTunnel**: `devtunnel` (auto-detects everything!)
+6. **Get your public URL** and share it! 🌍
+
+**Example:**
+```bash
+# Terminal 1 - Your dev server
+cd my-react-app
+npm run dev
+
+# Terminal 2 - DevTunnel (same directory!)
+cd my-react-app
+devtunnel
+```
 
-**Works with any command:** Vite, Create React App, Next.js, Express, NestJS, etc.
+**Works with any framework, API, or backend:** Vite, React, Next.js, Express, NestJS, FastAPI, Flask, Django, Spring Boot, Laravel, and any HTTP/HTTPS server!
 
 ---
 
@@ -90,7 +125,7 @@ MIT License - see [LICENSE](docs/LICENSE)
 
 ---
 
-**Version 3.0.6** | Made with ❤️ for developers worldwide
+**Version 3.0.10** | Made with ❤️ for developers worldwide
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtunnel-cli",
-  "version": "3.0.9",
+  "version": "3.0.11",
   "type": "module",
   "description": "DevTunnel - Share local dev servers worldwide. Zero configuration tunnel for any framework. Install via npm: npm install -g devtunnel-cli. Works with Vite, React, Next.js, Express, NestJS and more.",
   "main": "src/core/start.js",

package/src/core/RUN.js

@@ -9,6 +9,15 @@ import { dirname, join } from "path";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
+// Suppress deprecation warnings from dependencies (harmless - from http-proxy/localtunnel)
+const originalEmitWarning = process.emitWarning;
+process.emitWarning = function(warning, ...args) {
+  if (typeof warning === 'string' && warning.includes('util._extend')) {
+    return; // Suppress this specific deprecation warning
+  }
+  return originalEmitWarning.call(this, warning, ...args);
+};
+
 // Clear screen before starting
 process.stdout.write('\x1B[2J\x1B[0f');
 console.clear();

package/src/core/start.js

@@ -136,15 +136,16 @@ async function autoDetectProject() {
     const packageJson = JSON.parse(readFileSync(packagePath, 'utf8'));
     const projectName = packageJson.name || basename(currentDir);
     
-    // Try to detect port
-    let detectedPort = detectPortFromPackage(packagePath);
+    // FIRST: Check for running dev servers (priority)
+    const runningPorts = await detectRunningDevServer();
+    let detectedPort = null;
     
-    // If no port detected, check running servers
-    if (!detectedPort) {
-      const runningPorts = await detectRunningDevServer();
-      if (runningPorts.length > 0) {
-        detectedPort = runningPorts[0]; // Use first detected port
-      }
+    if (runningPorts.length > 0) {
+      // Use running server port (most accurate)
+      detectedPort = runningPorts[0];
+    } else {
+      // Fallback: Try to detect port from package.json
+      detectedPort = detectPortFromPackage(packagePath);
     }
     
     return {
@@ -183,7 +184,7 @@ async function main() {
   // Show ASCII logo
   showLogo();
   
-  console.log("DevTunnel v3.0.9");
+  console.log("DevTunnel v3.0.11");
   console.log("Share your local dev servers worldwide");
   console.log("");
   console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
@@ -281,10 +282,48 @@ async function main() {
     // Auto-detected project with port
     projectPath = autoDetected.path;
     projectName = autoDetected.name;
-    devPort = autoDetected.port;
+    
+    // Double-check: verify the port is actually in use
+    const portInUse = await checkPortInUse(autoDetected.port);
+    
+    if (!portInUse) {
+      // Detected port is not actually running, check for other running servers
+      console.log(`Detected port ${autoDetected.port} from package.json, but no server running on that port`);
+      console.log("Checking for running dev servers...");
+      
+      const runningPorts = await detectRunningDevServer();
+      if (runningPorts.length > 0) {
+        if (runningPorts.length === 1) {
+          devPort = runningPorts[0];
+          console.log(`Found running dev server on port: ${devPort}`);
+        } else {
+          console.log(`Found ${runningPorts.length} running dev server(s) on port(s): ${runningPorts.join(', ')}`);
+          const portResponse = await prompts({
+            type: "select",
+            name: "port",
+            message: "Select port:",
+            choices: runningPorts.map(p => ({ title: `Port ${p}`, value: p }))
+          });
+          
+          if (!portResponse.port) {
+            console.log("ERROR: No port selected");
+            process.exit(1);
+          }
+          
+          devPort = portResponse.port;
+        }
+      } else {
+        // No running servers, use detected port (user might start it later)
+        devPort = autoDetected.port;
+        console.log(`Using detected port: ${devPort} (make sure dev server is running)`);
+      }
+    } else {
+      // Port is in use, use it
+      devPort = autoDetected.port;
+    }
     
     console.log(`Detected project: ${projectName}`);
-    console.log(`Detected port: ${devPort}`);
+    console.log(`Using port: ${devPort}`);
     console.log(`Using current directory: ${projectPath}`);
     console.log("");