Skip to content

maiz-an/DevTunnel-CLI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

168 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

DevTunnel-CLI πŸš€

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

License: MIT Platform npm version

🌐 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


πŸ› οΈ 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