All notable changes to DevTunnel will be documented in this file.
- CI compatibility - Removed Node 16 from GitHub Actions test matrix (
18.x,20.xonly) because dependency toolchain now requires newer Node fornpm ci. - Release version - Bumped package version for GitHub/npm release alignment.
- Website - maizan.me/devtunnel-cli proxied from devtunnel-cli.vercel.app. All references updated; no mzieos.com.
- Website URL - Now at maizan.me/devtunnel-cli (proxied from portfolio). Old domain redirects to new URL for SEO continuity.
- README/package - Homepage and all links updated to maizan.me/devtunnel-cli. npm emphasized as primary install source.
- npm & website - Canonical URL without www: devtunnel-cli.mzieos.com everywhere; website redirects www → non-www
- Contributor - .mailmap and CONTRIBUTING note so automated commits can be attributed to main author
- Official domain - Website: https://devtunnel-cli.mzieos.com (all references updated in CLI repo + website repo)
- README: title "DevTunnel-CLI" for npm
- Example URLs: generic https://your-app.serviceprovider.com (website + docs/FEATURES.md)
- Website: Weekly Downloads from npm API; hero text; all example URLs updated
- npm package page: ensure latest shows devtunnel-cli.mzieos.com and maiz-an/DevTunnel-CLI (README + package.json)
- Repo & website rename - GitHub: maiz-an/DevTunnel-CLI, website: devtunnel-cli.mzieos.com (npm package page updated)
- README: production-only content; removed search keywords section
- CONTRIBUTING: correct package name (devtunnel-cli)
- .npmignore: removed references to deleted files
- GitHub release workflow: concise install/website body
- Docs: only Features, Troubleshooting, Contributing, License (production-ready)
- PHP/XAMPP detection - Auto-detect projects with
index.php(port 80) - XAMPP subfolder support - Base path for
htdocs/ProjectNamesohttp://localhost/PeopleQ/works via tunnel - Port 80 in common ports - Detects running Apache/XAMPP
- Proxy accepts optional base path for path rewriting (XAMPP subfolders)
- Port override prompt - When using detected project, can keep default port or type another (e.g. HTML default 5500)
- Manual folder pick suggests 5500 for HTML, 80 for PHP
- HTML default port 5500 - Matches VS Code Live Server; built-in static server uses 5500
- Port scan order - 5500 before 8080 so Live Server is preferred
- Static server path fix - Forward-slash paths on Windows so CSS/JS in subfolders load correctly
- HTML tunnel CSS/JS - Strip query string from asset paths; rewrite absolute localhost URLs in HTML so styles/scripts work through tunnel
- Version command -
devtunnel-cli --version,-v, or--vprints version and exits
- npm page - Explicit
filesin package.json; version from package.json in CLI; README install command and links use devtunnel-cli
- README: install command
devtunnel-cli, remove hardcoded version, fix npm package links
- HTML built-in static server - When HTML project and no server running, start static server and wait until ready before tunnel
- waitForServerReady() - Poll port until server responds (HTML flow)
- Suppress
util._extenddeprecation in proxy (dynamic import of http-proxy)
- Version display - Read version from package.json so CLI banner shows correct version
- HTML project detection -
index.htmlin root → default port 8080 (then 5500) - Laravel/PHP detection -
composer.json+artisan→ default port 8000 (php artisan serve) - detectLaravelProject(), detectHtmlProject() - Project-type helpers
- Common ports - 5500 (Live Server), 8000 (Laravel) in port scan
- Auto-detect order - Laravel first, then Node (package.json), then HTML
- Manual folder pick suggests 8000 for Laravel, 8080 for HTML
- (Version bump; features in 3.0.17)
- Command Name - Changed command from
devtunneltodevtunnel-clifor consistency with package name - Consistency - Package name and command are now both
devtunnel-cli
- Privilege Elevation - Fixed automatic admin privilege request implementation
- Automatic Privilege Elevation - DevTunnel now automatically requests administrator privileges on Windows when permission errors occur
- Smart Permission Handling - Detects permission errors and prompts for elevation instead of failing
- Better UX - No need to manually run as administrator; DevTunnel handles it automatically
- Permission Errors - Improved error handling for EPERM/EACCES errors when downloading Cloudflare binary
- File Cleanup - Safe file deletion that handles locked files gracefully
- Error Messages - Clear, actionable error messages for permission issues with solutions
- Code Quality - Cleaned up comments and improved code readability
- Error Recovery - Better handling of file write errors with specific guidance
- Manual Launchers - Removed START.bat, START.command, and START.sh files
- Legacy Installation Methods - npm install is now the only supported installation method
- Deprecation Warning - Suppressed harmless
util._extendwarning from dependencies - Cleaner Output - No more deprecation warnings cluttering the console
-### Changed
- Installation Method - DevTunnel now exclusively uses npm for installation (
npm i -g devtunnel-cli) - Documentation - Updated all docs to reflect npm-only installation
- Documentation - Added comprehensive list of supported frameworks and backends
- Clarified Support - Explicitly states DevTunnel works with ALL APIs and backends
- Simplified Workflow - Removed confusion about multiple installation methods
- Port Detection Priority - Now prioritizes running dev servers over package.json defaults
- Port Verification - Verifies detected port is actually in use before using it
- Better Detection - Checks for running servers first, then falls back to package.json
- Detection Logic - Running servers are checked first, ensuring accurate port detection
- User Feedback - Better messages when port detection finds mismatches
- Automatic Project Detection - Auto-detects project in current directory when running
devtunnel-cli - Automatic Port Detection - Detects port from package.json scripts or running dev servers
- Smart Port Selection - Automatically uses running dev server port if detected
- Multiple Project Support - Easy selection when multiple projects are running
- Intelligent Fallback - Falls back to folder picker if no project detected
- Improved Workflow - No need to manually select folder and port if project is detected
- Better UX - Confirms auto-detected project before proceeding
- Cross-Platform - Works seamlessly on Windows, macOS, and Linux
- If you run
devtunnel-cliin a project directory with a running dev server, it auto-detects everything - If multiple projects are running, you can select which port to use
- If no project detected, falls back to folder picker (existing behavior)
- Startup Display - Removed developer name, added npm package link
- Info Header - Now shows Repository, npm Package, and Website links
- Streaming Support - Enhanced proxy server with better support for video/audio file streaming
- Timeout Handling - Increased timeout to 5 minutes for large file transfers
- File Streaming Documentation - Added comprehensive documentation about file size limitations
- Proxy Server - Improved timeout handling and streaming support for large files
- Features Documentation - Added limitations section explaining Cloudflare free tier constraints
- README - Added streaming support to features list
- Large File Streaming - Better handling of video/audio files with proper timeout configuration
- Stream Cancellation Errors - Improved error handling for interrupted streams
- Updated ASCII Logo - Replaced with exact logo design using █ and ▒ characters
- Improved UI Spacing - Added proper spacing around lines and sections for better readability
- Better Visual Hierarchy - Cleaner output with consistent spacing throughout
- Updated ASCII Logo - Replaced with exact stylized "DevTunnel" logo design (box-drawing characters)
- Updated ASCII Logo - Replaced with exact stylized "DevTunnel" logo design
- ASCII Logo - Professional ASCII art logo displayed at startup
- Improved Screen Clearing - Better terminal clearing for fresh start on all platforms
- Fullscreen Support - Clears screen and positions cursor at top for clean display
- Clean UI Design - Removed box UI, replaced with simple lines for professional look
- Reduced Font Size - Standard font size throughout (no oversized text)
- App & Developer Info - Added header with app details and developer information at startup
- Simplified Output - Clean, minimal output like real-world CLI tools
- Removed Emojis - Professional text-only output
-### Fixed
- npm Install Path Issue - Fixed module resolution error when installed via
npm i -g devtunnel-cli - Path resolution now works correctly for both npm install and repo run methods
- npm Package - Published as
devtunnelon npm for easy global installation - Bundled Cloudflare - Automatically downloads on first run, no installation needed
- Enterprise Error Handling - Retry logic, multiple sources, comprehensive error messages
- Smart Proxy Server - Bypasses Vite/React host restrictions without config changes
- Cross-Platform Native Dialogs - Modern folder picker for Windows, macOS, Linux
- Professional UI - Clean, consistent output design
- Multi-Service Fallback - Cloudflare → Ngrok → LocalTunnel for 99.9% uptime
- Improved UI - Consistent, professional box designs across all platforms
- Dynamic Path Detection - Works with any folder name, handles paths with spaces
- Security Policy - Added SECURITY.md and CODE_OF_CONDUCT.md
- Website - Professional landing page at devtunnel-cli.mzieos.com
- Refactored to ES modules for better compatibility
- Improved folder structure (organized into core, utils, config)
- Enhanced documentation (15+ docs in
/docsfolder) - Better error messages with troubleshooting steps
- Faster startup time with optimized checks
- Cloudflare certificate errors (auto-fix prompt)
- Vite "Blocked request" issues (proxy solution)
- LocalTunnel password page (fallback prioritization)
- Inconsistent UI across different terminals
- Permission issues on Unix systems
- Path handling with spaces (Windows compatibility)
- Dynamic project root detection (works with any folder name)
- Node.js: 16+ required
- Cloudflare: Auto-bundled (~40MB download on first run)
- Platform Support: Windows, macOS, Linux
- Framework Support: All (Vite, React, Next.js, Express, NestJS, etc.)
Legacy versions before major refactor. See git history for details.
See CONTRIBUTING.md for how to contribute to DevTunnel.
MIT License - see LICENSE