devtunnel-cli 3.0.25 → 3.0.27

package/README.md

@@ -5,9 +5,8 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)](https://github.com/maiz-an/DevTunnel)
 [![npm version](https://img.shields.io/npm/v/devtunnel-cli)](https://www.npmjs.com/package/devtunnel-cli)
-[![GitHub Pages](https://img.shields.io/badge/GitHub-Pages-blue)](https://maiz-an.github.io/DevTunnel/)
 
-🌐 **Website:** [devtunnel.vercel.app](https://devtunnel.vercel.app) | 📦 **npm:** [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) | 💻 **GitHub Pages:** [maiz-an.github.io/DevTunnel](https://maiz-an.github.io/DevTunnel/)
+🌐 **Website:** [devtunnel.vercel.app](https://devtunnel.vercel.app) | 📦 **npm:** [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) | 💻 **GitHub:** [maiz-an/DevTunnel](https://github.com/maiz-an/DevTunnel)
 
 ---
 
@@ -25,20 +24,21 @@ npm install -g devtunnel-cli
 cd your-project
 ```
 
-**3. Start your dev server (in one terminal):**
+**3. Have your app running (in one terminal):**
 ```bash
-npm start
-# OR
 npm run dev
+# OR  php artisan serve   (Laravel)
+# OR  XAMPP / Live Server (PHP/HTML)
+# HTML: optional — DevTunnel can start a built-in server
 ```
 
 **4. Run DevTunnel (in another terminal, same directory):**
 ```bash
-cd your-project  # Same directory where you run npm start
-devtunnel-cli        # Auto-detects project and port!
+cd your-project  # Same directory as your project
+devtunnel-cli    # Auto-detects project type and port!
 ```
 
-**That's it!** DevTunnel will automatically detect your project and running dev server port.
+**That's it!** DevTunnel auto-detects Node, Laravel, HTML, and PHP/XAMPP projects.
 
 ---
 
@@ -48,7 +48,9 @@ devtunnel-cli        # Auto-detects project and port!
 - 🎯 **Zero Config** - No project changes needed
 - 🔗 **Smart Proxy** - Bypasses Vite/React restrictions
 - 🌍 **Cross-Platform** - Windows, macOS, Linux
-- 🚀 **Any Framework** - Works with all
+- 🚀 **Any Framework** - Node, React, Laravel, plain HTML, PHP/XAMPP
+- 📄 **HTML** - Default port 5500; built-in static server if none running
+- 🐘 **PHP/XAMPP** - Port 80; supports htdocs subfolders (e.g. http://localhost/YourProject/)
 - 🔄 **Multi-Service** - Cloudflare, Ngrok, LocalTunnel fallback
 - 📹 **Streaming Support** - Handles video/audio files (with limitations for large files)
 
@@ -56,37 +58,36 @@ devtunnel-cli        # Auto-detects project and port!
 
 ## 💡 How to Use
 
-**Important:** Run `devtunnel-cli` from the same directory where you run `npm start` or `npm run dev`!
+**Important:** Run `devtunnel-cli` from the same directory as your project!
 
 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)
+2. **Go to your project**: `cd your-project` (Node, Laravel, HTML, or XAMPP folder)
+3. **Have your app running**: `npm run dev`, `php artisan serve`, or XAMPP. For HTML, optional — DevTunnel can serve it.
 4. **Open a new terminal** in the same project directory
-5. **Run DevTunnel**: `devtunnel-cli` (auto-detects everything!)
+5. **Run DevTunnel**: `devtunnel-cli` (auto-detects project type and port!)
 6. **Get your public URL** and share it! 🌍
 
-**Example:**
+**Example (Node):**
 ```bash
-# Terminal 1 - Your dev server
+# Terminal 1
 cd my-react-app
 npm run dev
 
-# Terminal 2 - DevTunnel (same directory!)
+# Terminal 2 - same directory
 cd my-react-app
 devtunnel-cli
 ```
 
-**Works with any framework, API, or backend:** Vite, React, Next.js, Express, NestJS, FastAPI, Flask, Django, Spring Boot, Laravel, and any HTTP/HTTPS server!
+**Works with:** Vite, React, Next.js, Express, NestJS, Laravel, plain HTML, PHP/XAMPP, and any HTTP/HTTPS server.
 
 ---
 
 ## 📖 Documentation
 
-Complete docs in `/docs` folder:
-- [Complete Guide](docs/README.md)
 - [Features](docs/FEATURES.md)
 - [Troubleshooting](docs/TROUBLESHOOTING.md)
-- [GitHub Pages Website](docs/DEPLOY-WEBSITE.md)
+- [Contributing](docs/CONTRIBUTING.md)
+- [License](docs/LICENSE)
 
 ---
 
@@ -118,9 +119,7 @@ MIT License - see [LICENSE](docs/LICENSE)
 
 ## 📦 Installation & Links
 
-- **npm Package**: [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli)
-- **GitHub Repository**: [maiz-an/DevTunnel](https://github.com/maiz-an/DevTunnel)
-- **GitHub Pages**: [maiz-an.github.io/DevTunnel](https://maiz-an.github.io/DevTunnel/)
-- **Official Website**: [devtunnel.vercel.app](https://devtunnel.vercel.app)
-- **Documentation**: [docs/README.md](docs/README.md)
+- **Website**: [devtunnel.vercel.app](https://devtunnel.vercel.app)
+- **npm**: [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli)
+- **GitHub**: [maiz-an/DevTunnel](https://github.com/maiz-an/DevTunnel)
 - **Issues**: [GitHub Issues](https://github.com/maiz-an/DevTunnel/issues)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtunnel-cli",
-  "version": "3.0.25",
+  "version": "3.0.27",
   "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, Laravel (PHP), HTML, and more.",
   "main": "src/core/start.js",

package/src/core/proxy-server.js

@@ -8,13 +8,14 @@ process.emitWarning = function (warning, ...args) {
 };
 const { default: httpProxy } = await import("http-proxy");
 
-// Get ports from command line
+// Get ports and optional base path from command line
 const TARGET_PORT = parseInt(process.argv[2]); // Your dev server port
 const PROXY_PORT = parseInt(process.argv[3]);  // Port for tunnel to connect to
 const PROJECT_NAME = process.argv[4] || "Project";
+const BASE_PATH = process.argv[5] || ""; // e.g. /PeopleQ for XAMPP htdocs/PeopleQ
 
 if (!TARGET_PORT || !PROXY_PORT) {
-  console.error("Usage: node proxy-server.js <target-port> <proxy-port> [project-name]");
+  console.error("Usage: node proxy-server.js <target-port> <proxy-port> [project-name] [base-path]");
   process.exit(1);
 }
 
@@ -63,12 +64,22 @@ const server = http.createServer((req, res) => {
     return;
   }
   
+  // XAMPP subfolder: rewrite path so / → /PeopleQ/, /style.css → /PeopleQ/style.css
+  if (BASE_PATH) {
+    const prefix = BASE_PATH.replace(/\/$/, "");
+    req.url = prefix + (req.url === "/" ? "/" : req.url);
+  }
+  
   // Proxy the request
   proxy.web(req, res);
 });
 
 // Handle WebSocket upgrade (for Vite HMR)
 server.on("upgrade", (req, socket, head) => {
+  if (BASE_PATH) {
+    const prefix = BASE_PATH.replace(/\/$/, "");
+    req.url = prefix + (req.url === "/" ? "/" : req.url);
+  }
   proxy.ws(req, socket, head);
 });
 
@@ -78,7 +89,7 @@ server.listen(PROXY_PORT, () => {
   console.log("DevTunnel Proxy Server");
   console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
   console.log(`Project: ${PROJECT_NAME}`);
-  console.log(`Dev Server: http://localhost:${TARGET_PORT}`);
+  console.log(`Dev Server: http://localhost:${TARGET_PORT}${BASE_PATH || ""}`);
   console.log(`Proxy Port: ${PROXY_PORT}`);
   console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
   console.log("Ready! Tunnel will connect to proxy");

package/src/core/start.js

@@ -17,10 +17,10 @@ function getPackageVersion() {
     const pkgPath = join(PROJECT_ROOT, "package.json");
     if (existsSync(pkgPath)) {
       const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-      return pkg.version || "3.0.25";
+      return pkg.version || "3.0.27";
     }
   } catch (err) {}
-  return "3.0.25";
+  return "3.0.27";
 }
 
 // Helper to run command
@@ -136,9 +136,17 @@ function detectHtmlProject(currentDir) {
   return { name: basename(currentDir), defaultPort: 5500 }; // Live Server default; matches VS Code
 }
 
+// Detect PHP/XAMPP project (index.php in root, not Laravel)
+function detectPhpProject(currentDir) {
+  if (detectLaravelProject(currentDir)) return null; // Laravel has its own flow
+  const indexPhp = join(currentDir, "index.php");
+  if (!existsSync(indexPhp)) return null;
+  return { name: basename(currentDir), defaultPort: 80 }; // XAMPP/Apache default
+}
+
 // Check common ports for running dev servers (includes Laravel 8000, XAMPP/Live Server 8080/5500)
 async function detectRunningDevServer() {
-  const commonPorts = [3000, 5173, 5500, 8080, 8000, 5000, 4000, 3001, 5174]; // 5500 before 8080 for Live Server
+  const commonPorts = [3000, 5173, 5500, 8080, 8000, 80, 5000, 4000, 3001, 5174]; // 80 for XAMPP
   const detected = [];
   
   for (const port of commonPorts) {
@@ -218,6 +226,18 @@ async function autoDetectProject() {
     };
   }
 
+  // 4) PHP/XAMPP (index.php) — default port 80 (Apache), e.g. http://localhost/PeopleQ/
+  const php = detectPhpProject(currentDir);
+  if (php) {
+    const detectedPort = runningPorts.length > 0 ? runningPorts[0] : php.defaultPort;
+    return {
+      path: currentDir,
+      name: php.name,
+      port: detectedPort,
+      projectType: "php"
+    };
+  }
+
   return null;
 }
 
@@ -355,7 +375,9 @@ async function main() {
           ? "Laravel (php artisan serve)"
           : autoDetected.projectType === "html"
             ? "HTML project"
-            : "package.json";
+            : autoDetected.projectType === "php"
+              ? "PHP/XAMPP"
+              : "package.json";
       console.log(`Detected port ${autoDetected.port} (${portSource}), but no server running on that port`);
       console.log("Checking for running dev servers...");
       
@@ -521,15 +543,18 @@ async function main() {
     console.log(`Selected: ${projectPath}`);
     console.log("");
     
-    // Try to detect port for selected project (Laravel → 8000, HTML → 8080, Node from package.json)
+    // Try to detect port for selected project (Laravel → 8000, HTML → 5500, PHP → 80, Node from package.json)
     const selectedPackagePath = join(projectPath, "package.json");
     const laravelSelected = detectLaravelProject(projectPath);
     const htmlSelected = detectHtmlProject(projectPath);
+    const phpSelected = detectPhpProject(projectPath);
     let detectedPort = laravelSelected
       ? laravelSelected.defaultPort
       : htmlSelected
         ? htmlSelected.defaultPort  // 5500
-        : detectPortFromPackage(selectedPackagePath);
+        : phpSelected
+          ? phpSelected.defaultPort  // 80
+          : detectPortFromPackage(selectedPackagePath);
     
     // Check for running servers
     const runningPorts = await detectRunningDevServer();
@@ -557,11 +582,17 @@ async function main() {
   console.log("");
   const proxyPort = devPort + 1000; // Use port 1000 higher for proxy
 
+  // XAMPP subfolder (e.g. htdocs/PeopleQ → http://localhost/PeopleQ/) — proxy rewrites path
+  const isPhpXamppSubfolder =
+    devPort === 80 &&
+    (projectPath.toLowerCase().includes("htdocs") || projectPath.toLowerCase().includes("www"));
+  const basePath = isPhpXamppSubfolder ? "/" + basename(projectPath) : "";
+
   console.log("");
   console.log("Configuration:");
   console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
   console.log(`Project: ${projectName}`);
-  console.log(`Dev Server: localhost:${devPort}`);
+  console.log(`Dev Server: localhost:${devPort}${basePath || ""}`);
   console.log(`Proxy Port: ${proxyPort}`);
   console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
   console.log("");
@@ -593,7 +624,9 @@ async function main() {
   console.log("Starting services...");
   console.log("");
   const proxyPath = join(__dirname, "proxy-server.js");
-  const proxyProcess = spawn("node", [proxyPath, devPort.toString(), proxyPort.toString(), projectName], {
+  const proxyArgs = [proxyPath, devPort.toString(), proxyPort.toString(), projectName];
+  if (basePath) proxyArgs.push(basePath);
+  const proxyProcess = spawn("node", proxyArgs, {
     stdio: "inherit",
     shell: false
   });

package/src/utils/pages/index.html

@@ -0,0 +1,73 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="description" content="DevTunnel - Share local dev servers worldwide. Zero configuration tunnel for any framework. Install via npm: npm install -g devtunnel-cli">
+  <meta name="keywords" content="dev tunnel, localhost tunnel, cloudflare, ngrok, port forwarding, local development, vite, react, nextjs, laravel, php, html, npm install, devtunnel">
+  <meta name="author" content="maiz">
+  <meta name="robots" content="index, follow">
+  <link rel="canonical" href="https://devtunnel.vercel.app/">
+  <meta property="og:title" content="DevTunnel - Share Local Servers Worldwide">
+  <meta property="og:description" content="Zero configuration tunnel for any framework. Install via npm: npm install -g devtunnel-cli">
+  <meta property="og:url" content="https://devtunnel.vercel.app/">
+  <meta property="og:type" content="website">
+  <meta property="og:image" content="https://devtunnel.vercel.app/og-image.png">
+  <meta name="twitter:card" content="summary_large_image">
+  <meta name="twitter:title" content="DevTunnel - Share Local Servers Worldwide">
+  <meta name="twitter:description" content="Zero configuration tunnel for any framework">
+  <meta name="twitter:image" content="https://devtunnel.vercel.app/og-image.png">
+  <title>DevTunnel - Share Local Servers Worldwide</title>
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; max-width: 800px; margin: 0 auto; padding: 20px; line-height: 1.6; }
+    h1 { color: #3b82f6; }
+    .badge { display: inline-block; padding: 4px 8px; background: #3b82f6; color: white; border-radius: 4px; margin: 5px; text-decoration: none; }
+    .links { margin: 20px 0; }
+    .links a { margin-right: 15px; color: #3b82f6; text-decoration: none; }
+    code { background: #f4f4f4; padding: 2px 6px; border-radius: 3px; }
+    pre { background: #1e293b; color: #f1f5f9; padding: 15px; border-radius: 5px; overflow-x: auto; }
+  </style>
+</head>
+<body>
+  <h1>🚀 DevTunnel</h1>
+  <p><strong>Share your local dev servers worldwide - Zero config tunnel for any framework</strong></p>
+  
+  <div class="links">
+    <a href="https://www.npmjs.com/package/devtunnel-cli" class="badge">📦 npm Package</a>
+    <a href="https://devtunnel.vercel.app" class="badge">🌐 Website</a>
+    <a href="https://github.com/maiz-an/DevTunnel" class="badge">💻 GitHub</a>
+  </div>
+
+  <h2>⚡ Quick Start</h2>
+  <h3>Install via npm (Recommended)</h3>
+  <pre><code>npm install -g devtunnel-cli
+devtunnel-cli</code></pre>
+
+  <h2>✨ Features</h2>
+  <ul>
+    <li>🤖 Fully Automatic - Cloudflare bundled, no installation needed</li>
+    <li>🎯 Zero Config - No project changes needed</li>
+    <li>🔗 Smart Proxy - Bypasses Vite/React restrictions</li>
+    <li>🌍 Cross-Platform - Windows, macOS, Linux</li>
+    <li>🚀 Any Framework - Works with all</li>
+    <li>🔄 Multi-Service - Cloudflare, Ngrok, LocalTunnel fallback</li>
+    <li>🍃 Laravel (PHP) - Auto port 8000, XAMPP/htdocs base path</li>
+    <li>📄 HTML - Default port 5500 (Live Server), built-in static server</li>
+    <li>🐘 PHP/XAMPP - Port 80, http://localhost/ProjectName/</li>
+  </ul>
+
+  <h2>📖 Documentation</h2>
+  <p>Complete documentation in the <a href="https://github.com/maiz-an/DevTunnel/tree/main/docs">docs/</a> folder.</p>
+
+  <h2>🔗 Links</h2>
+  <ul>
+    <li><a href="https://www.npmjs.com/package/devtunnel-cli">npm Package (devtunnel-cli)</a></li>
+    <li><a href="https://devtunnel.vercel.app">Official Website</a></li>
+    <li><a href="https://github.com/maiz-an/DevTunnel">GitHub Repository</a></li>
+    <li><a href="https://github.com/maiz-an/DevTunnel/issues">Report Issues</a></li>
+  </ul>
+
+  <hr>
+  <p><small>Version 3.0.27 | Made with ❤️ for developers worldwide</small></p>
+</body>
+</html>

package/src/utils/pages/WEBSITE-INFO.md

@@ -1,182 +0,0 @@
-# 🌐 DevTunnel Website Information
-
-## 📍 Public Website Repository
-
-**GitHub:** https://github.com/maiz-an/DevTunnelPages
-
-**Live URL:** https://devtunnel.vercel.app ✅ LIVE
-
-**Deployment Date:** January 28, 2026
-
----
-
-## 🏗️ Architecture
-
-### **This Folder (`src/utils/pages/`):**
-- Contains original HTML/CSS/JS prototype
-- **Private** (in `.gitignore`)
-- For internal reference only
-- Not published to GitHub
-
-### **Public Repository (`DevTunnelPages`):**
-- Next.js 15 + TypeScript version
-- Tailwind CSS styling
-- Vercel-optimized
-- **Public** on GitHub
-- Production-ready
-
----
-
-## 📁 Files in This Folder
-
-```
-src/utils/pages/
-├── index.html          ← Original HTML landing page
-├── styles.css          ← Original custom CSS
-├── script.js           ← Original JavaScript
-├── README.md           ← Hosting instructions (HTML version)
-├── PREVIEW.bat         ← Windows preview launcher
-└── WEBSITE-INFO.md     ← This file (website details)
-```
-
----
-
-## 🚀 Deployment Process
-
-1. **Prototype Created:** HTML/CSS/JS version here (private)
-2. **Converted to Next.js:** Created DevTunnelPages repo
-3. **Deployed to Vercel:** https://vercel.com/new
-4. **Auto-Deploy:** Every push to main → automatic rebuild
-
----
-
-## 🔄 Update Process
-
-**To Update the Website:**
-
-1. Clone DevTunnelPages:
-   ```bash
-   cd G:\GitHubRep
-   cd DevTunnelPages
-   ```
-
-2. Edit files:
-   ```
-   app/page.tsx        ← Main content
-   app/globals.css     ← Styles
-   ```
-
-3. Test locally:
-   ```bash
-   npm install
-   npm run dev
-   ```
-
-4. Push changes:
-   ```bash
-   git add .
-   git commit -m "Update website"
-   git push
-   ```
-
-5. Vercel auto-deploys in 2-3 minutes ✅
-
----
-
-## 📊 Tech Stack Comparison
-
-| Aspect | This Folder (Private) | DevTunnelPages (Public) |
-|--------|----------------------|------------------------|
-| **Format** | HTML/CSS/JS | Next.js 15 + TypeScript |
-| **Styling** | Custom CSS | Tailwind CSS |
-| **Purpose** | Prototype/Reference | Production Website |
-| **Hosting** | Not hosted | Vercel |
-| **Git** | Ignored (private) | Public repo |
-| **Updates** | Manual edit | Git push → auto-deploy |
-
----
-
-## 🔗 Important Links
-
-- **Public Repo:** https://github.com/maiz-an/DevTunnelPages
-- **Vercel Deploy:** https://vercel.com/new
-- **Main DevTunnel:** https://github.com/maiz-an/DevTunnel
-- **Deployment Guide:** See DevTunnelPages/DEPLOY.md
-
----
-
-## 🔐 Privacy Note
-
-This folder (`src/utils/pages/`) is in `.gitignore` and will NOT be pushed to GitHub.
-Only visible in local repository for development reference.
-
----
-
-## 💡 Quick Reference
-
-**Deploy Command (from DevTunnelPages):**
-```bash
-git push  # Vercel auto-deploys
-```
-
-**Local Preview (from DevTunnelPages):**
-```bash
-npm run dev  # http://localhost:3000
-```
-
-**Production Build (from DevTunnelPages):**
-```bash
-npm run build
-npm start
-```
-
----
-
-**Last Updated:** January 28, 2026
-**Status:** ✅ LIVE at https://devtunnel.vercel.app
-
-**Latest Changes (Jan 28, 2026):**
-- ✅ Updated to Next.js 15 (latest version)
-- ✅ Added favicons (all sizes)
-- ✅ Updated npm install command to `devtunnel-cli`
-- ✅ Updated terminal demo to show `devtunnel` command
-- ✅ Added SEO metadata (OpenGraph, Twitter, Google Search Console)
-- ✅ Added sitemap.xml and robots.txt
-- ✅ Added npm link to navigation bar
-- ✅ Removed developer name from metadata
-- ✅ Added Google Search Console verification
-- ✅ Added structured data (JSON-LD) for SEO
-- ✅ Updated version to 3.0.10
-- ✅ Added auto-detection feature documentation
-- ✅ Added streaming support documentation
-- ✅ Improved features list with auto-detection
-
----
-
-## 🎉 Deployment Details
-
-**Live Website:** https://devtunnel.vercel.app
-
-**Build Stats:**
-- Build Time: ~32 seconds
-- Next.js Version: 15.1.6 (latest)
-- Total Pages: 4
-- First Load JS: 105 kB
-- Status: ✅ Successfully deployed
-- npm Package: `devtunnel-cli@3.0.10` (published and live)
-- Latest Features: Auto-detection, streaming support, improved port detection
-
-**Vercel Project:** devtunnel
-
-**Auto-Deploy:** ✅ Every push to main branch auto-deploys in ~30 seconds
-
----
-
-## 🔗 All Links
-
-| Purpose | URL |
-|---------|-----|
-| **Live Website** | https://devtunnel.vercel.app |
-| **Website Repo** | https://github.com/maiz-an/DevTunnelPages |
-| **Main DevTunnel** | https://github.com/maiz-an/DevTunnel |
-| **Vercel Dashboard** | https://vercel.com/dashboard |