DevTunnel-CLI 🚀

Share your local dev servers worldwide - Zero config tunnel for any framework

🌐 Website: devtunnel-cli.vercel.app | 📦 npm: devtunnel-cli | 💻 GitHub: maiz-an/DevTunnel-CLI | 💬 Discord: Join the community

Install

npm i -g devtunnel-cli

Then run devtunnel-cli from your project directory.

Optional: force a specific local port when needed:

devtunnel-cli --port 5174

---

🎯 Purpose & Scope

DevTunnel-CLI is designed for DEVELOPMENT, TESTING, DEMOS, and WEBHOOK DEBUGGING. It provides fast, frictionless access to your local dev servers from anywhere.

DevTunnel-CLI is built for developers who need instant public URLs to share work-in-progress, test on mobile devices, demo features to clients, or debug webhooks from third-party services.

---

⚡ Quick Start

Step-by-Step Guide

1. Install DevTunnel (one-time setup):

npm i -g devtunnel-cli

2. Navigate to your project directory:

cd your-project

3. Have your app running (in one terminal):

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):

cd your-project  # Same directory as your project
devtunnel-cli    # Auto-detects project type and port!

That's it! DevTunnel auto-detects Node, Laravel, HTML, and PHP/XAMPP projects.

Port priority logic:

1. --port / -p flag (if provided)
2. Auto-detected running local dev server port
3. Framework default fallback (for example Vite 5173)

---

✨ Features

• 🤖 Fully Automatic - Cloudflare bundled, no installation needed
• 🎯 Zero Config - No project changes needed
• 🔗 Smart Proxy - Bypasses Vite/React restrictions
• 🌍 Cross-Platform - Windows, macOS, Linux
• 🚀 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
• 🔌 Multiple Ports - DevTunnel-CLI supports multiple ports; auto-detects or lets you choose
• 📹 Streaming Support - Handles video/audio files

---

💡 How to Use

Important: Run devtunnel-cli from the same directory as your project!

1. Install DevTunnel (one-time): npm i -g devtunnel-cli — see Install above.
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 project type and port!)
6. Get your public URL and share it! 🌍

Example (Node):

# Terminal 1
cd my-react-app
npm run dev

# Terminal 2 - same directory
cd my-react-app
devtunnel-cli

Works with: Vite, React, Next.js, Express, NestJS, Laravel, plain HTML, PHP/XAMPP, and any HTTP/HTTPS server.

Automatic Port Detection

DevTunnel automatically scans active localhost dev ports and prioritizes the best match for your current project.

Example with multiple Vite apps:

• Project A runs on 5173
• Project B auto-shifts to 5174
• Running devtunnel-cli inside Project B detects and uses 5174

You can always override with:

devtunnel-cli --port 5174

---

📖 Documentation

• Features
• Troubleshooting
• Contributing
• License

---

🛠️ Requirements

• Node.js 16+ (nodejs.org).
• Internet connection and your dev server running.

Cloudflare is automatically bundled on first run.

---

📄 License

MIT License - see LICENSE

---

Latest on npm | Made with ❤︎ for developers worldwide

---

🔍 Search keywords

Find this project as: DevTunnel, devtunnel, dev-tunnel, Dev-Tunnel, DevTunnel-CLI, devtunnel-cli, dev-tunnel-cli, Dev-Tunnel-CLI. npm (install here): devtunnel-cli · Docs: devtunnel-cli.vercel.app · GitHub: maiz-an/DevTunnel-CLI.

---

📦 Links

• Website: devtunnel-cli.vercel.app
• npm: devtunnel-cli
• GitHub: maiz-an/DevTunnel-CLI
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Discord: Join the community