feat: update documentation and notes for public internet sharing feature with Cloudflare Tunnel and zrok support, emphasizing non-production use

Author: JeffGepiga

README.MD

@@ -13,6 +13,10 @@ Maintaining an old PHP 7.4 project while building a new Laravel 11 app on PHP 8.
 
 DevBox Pro is an Electron desktop app with a React renderer and a Node.js main process. It manages PHP, Node.js, MySQL, MariaDB, Redis, Nginx, Apache, PostgreSQL, MongoDB, MinIO, Memcached, Mailpit, phpMyAdmin, Composer, Git, and more from one local interface.
 
+> **Version 1.0.6:** This release focuses on **web server hardening** and the new **Share on Internet** option powered by **Cloudflare Tunnel** and **zrok**.
+>
+> **Important:** DevBox Pro is built for local development, testing, demos, and temporary preview links. It is **not** intended for production hosting or production traffic.
+
 ---
 
 ## ✨ Features
@@ -74,6 +78,7 @@ DevBox Pro is an Electron desktop app with a React renderer and a Node.js main p
 - Tunnel proxy rewrites redirects, cookies, and absolute local `.test` URLs so public sessions stay on the tunnel hostname
 - Cloudflare Quick Tunnels use random `*.trycloudflare.com` URLs
 - zrok requires a one-time app-wide enable token in **Binary Manager → Tools**
+- Built for previews and reviews, not for production deployment
 
 ### 🎯 Framework Support
 - **Laravel** - Full support with Artisan, Queue Workers, Scheduler
@@ -122,8 +127,8 @@ DevBox Pro is an Electron desktop app with a React renderer and a Node.js main p
 ### Installation
 
 1. **Download** the latest release for your platform:
-   - Windows: `DevBox-Pro-Setup-x.x.x.exe`
-   - macOS: `DevBox-Pro-x.x.x.dmg`
+  - Windows: `DevBox-Pro-Setup-1.0.6.exe`
+  - macOS: `DevBox-Pro-1.0.6.dmg`
 
 2. **Install** the application
 
@@ -150,6 +155,8 @@ DevBox Pro is an Electron desktop app with a React renderer and a Node.js main p
 
 > **Provider notes:** Cloudflare uses disposable random public URLs on `trycloudflare.com`. zrok requires a one-time app-wide enable step before any project can use it.
 
+> **Production note:** Tunnel sharing is intended for temporary previews, QA, and stakeholder review. Do not use DevBox Pro as a production hosting platform.
+
 ### Using Terminal Commands
 
 DevBox Pro lets you use `php`, `npm`, `node`, `composer`, `mysql`, and `mysqldump` directly from any terminal with automatic project version detection:

RELEASE.md

@@ -1,10 +1,10 @@
-# 🚀 DevBox Pro v1.0.5
+# 🚀 DevBox Pro v1.0.6
 
 **Stable Release | Your all-in-one local development environment for PHP & Node.js**
 
 ---
 
-## 🆕 What's New in v1.0.5
+## 🆕 What's New in v1.0.6
 
 ### ✨ New Features
 
@@ -16,71 +16,20 @@
 - Cloudflare public URLs are only surfaced once the `trycloudflare.com` hostname is resolvable, reducing broken fresh-tunnel links
 - zrok public URL detection has been updated for current CLI output formats
 
-#### ⚡ Improved Project Lifecycle Management
-- Immediate service stopping when the last active project is closed
-- Pending service shutdowns are automatically cancelled when starting new project services
-- Track projects currently being started or stopped for accurate status reporting
+### 🛡️ Web Server Hardening
 
-#### 🔄 Graceful Update Installation
-- Services are stopped before applying an app update via quit-and-install
+- Hardened mixed **Nginx** and **Apache** front-door handling when multiple projects and server versions are active
+- Improved proxy behavior so tunnel traffic keeps redirects, cookies, and absolute `.test` URLs on the public hostname
+- Reduced false-ready tunnel states by waiting for Cloudflare Quick Tunnel hostnames to become resolvable before surfacing them
+- Improved web server readiness and startup coordination to reduce port collisions and unstable starts
 
-#### 🪟 Enhanced Window & Migration Handling
-- New utility functions for window management and data migration
-
-#### 🗄️ Database Connection Improvements
-- Database connection info now displays the correct port for the selected engine version
-- Actual running port is used for active database connections instead of the default
-- Integrated service configuration for database port offsets across all components
-
-#### 💾 Database Import/Export
-- Import and export support for SQL, MongoDB, and PostgreSQL workflows
-
-#### 📦 Expanded Binary Downloads
-- One-click downloads for MySQL, MariaDB, Redis, Mailpit, phpMyAdmin, Nginx, Apache, and Node.js binaries
-- Download progress tracking and management
-- Dynamic loading of bundled binary configuration – new versions appear without an app update
-- Binary URL validation script added to the build pipeline
-
-#### 🌐 Front-Door Proxy & Service Serialization
-- Front-door proxy handling for Nginx and Apache projects with version checks
-- Serialized service starts for Apache and Nginx to prevent port collisions
-
-#### 🛑 Bulk Stop
-- Stop all running projects and services at once from the UI
-
-#### 🔗 Git Integration
-- Git download support with availability checks before clone operations
-
-#### 🔐 SSL & Import Enhancements
-- Enhanced SSL certificate management workflows
-- Improved project import functionality
-
-### 🏗️ Architecture & Refactoring
-
-- **Manager refactoring** – `CompatibilityManager` split into config and rules modules; `GitManager` split into smaller focused modules for improved maintainability
-- **Spawn hardening** – Removed `shell: true` from process spawning across the codebase to avoid `DEP0190` deprecation warnings and improve process handling
-- **Data path refactoring** – Centralized data path handling across services and utilities
-- **Binary removal** – Better error handling for locked files during binary removal
-- **MongoDB** – Enhanced binary detection and repair process
-- **MySQL** – Removed redundant logging during startup
-- **Nginx lifecycle** – Nginx is reloaded on rapid PHP-CGI port changes
-
-### 🧹 Bug Fixes & Improvements
+### 🧹 Fixes Included In This Release
 
 - Fixed public tunnel routing when multiple projects are running across Nginx and Apache
 - Fixed Cloudflare tunnel sessions showing the wrong project when multiple projects are shared
 - Fixed public tunnel flows that redirected browsers back to local `.test` URLs
 - Fixed stale or not-yet-ready Cloudflare Quick Tunnel hostnames being shown as live too early
-- Fixed multi-server version bugs when running multiple web server versions simultaneously
-- Fixed port conflict issues across services
-- Fixed WordPress installation bugs and added PHP extension toggles
-- Fixed terminal consuming excessive memory
-- Improved Nginx and Apache readiness check timeouts
-- Added MySQL error log handling and phpMyAdmin loading state management
-- Fixed bugs in PHP binary downloading
-- Compatibility management service with remote rule updates integrated into project creation
-- Added binary URL checking script to validate download URLs before build
-- Comprehensive test coverage: new unit tests for vhost configs, CLI, database, project services, and lifecycle utilities
+- Fixed multi-server version issues when running multiple web server versions simultaneously
 
 ---
 
@@ -160,8 +109,8 @@ mysqldump -u root mydb > backup.sql  # Dump with the active DB version
 
 | File | Description |
 |------|-------------|
-| **DevBox-Pro-Setup-1.0.5.exe** | Installer version (recommended) |
-| **DevBox-Pro-1.0.5.exe** | Portable version – no installation required |
+| **DevBox-Pro-Setup-1.0.6.exe** | Installer version (recommended) |
+| **DevBox-Pro-1.0.6.exe** | Portable version – no installation required |
 
 ### System Requirements (Windows)
 - **OS**: Windows 10/11 (64-bit)

docs/faq.html

@@ -134,6 +134,19 @@ <h2>❓ General Questions</h2>
             </div>
           </div>
         </div>
+
+        <div class="accordion-item">
+          <button class="accordion-header">
+            <span>Can I use DevBox Pro in production?</span>
+            <span class="accordion-chevron">▼</span>
+          </button>
+          <div class="accordion-body">
+            <div class="accordion-body-inner">
+              <p>No. DevBox Pro is designed for local development, testing, demos, and temporary preview environments.</p>
+              <p>Even with internet sharing through Cloudflare Tunnel or zrok, it is <strong>not meant for production use</strong> or long-term public hosting.</p>
+            </div>
+          </div>
+        </div>
       </div>
     </div>
   </section>
@@ -198,6 +211,20 @@ <h2>📁 Projects</h2>
             </div>
           </div>
         </div>
+
+        <div class="accordion-item">
+          <button class="accordion-header">
+            <span>Can I share a project on the internet?</span>
+            <span class="accordion-chevron">▼</span>
+          </button>
+          <div class="accordion-body">
+            <div class="accordion-body-inner">
+              <p>Yes. DevBox Pro 1.0.6 can expose a running project with <strong>Cloudflare Tunnel</strong> or <strong>zrok</strong>.</p>
+              <p>Enable <strong>"Share on Internet"</strong> in the project detail view, choose a provider, and start sharing. zrok also requires a one-time app-wide enable step in Binary Manager.</p>
+              <p>This is intended for previews, demos, and QA, not production deployment.</p>
+            </div>
+          </div>
+        </div>
       </div>
     </div>
   </section>

docs/features.html

@@ -4,7 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Features — DevBox Pro</title>
-  <meta name="description" content="Explore all DevBox Pro features: multi-PHP versions, Node.js support, database management, SSL certificates, terminal commands, and more.">
+  <meta name="description" content="Explore all DevBox Pro features: multi-PHP versions, Node.js support, public tunnel sharing, database management, SSL certificates, terminal commands, and more.">
   <link rel="icon" href="images/logo.png" type="image/png">
   <link rel="stylesheet" href="css/style.css">
 </head>
@@ -48,6 +48,15 @@ <h1 class="animate-in">
     </div>
   </section>
 
+  <section class="section" style="padding-top:0; padding-bottom:var(--space-2xl);">
+    <div class="container" style="max-width:900px;">
+      <div class="callout callout-warning animate-in" style="margin:0 auto;">
+        <span class="callout-icon">⚠️</span>
+        <p><strong>Important:</strong> DevBox Pro includes internet tunneling for previews and testing, but the app is <strong>not meant for production use</strong>.</p>
+      </div>
+    </div>
+  </section>
+
   <!-- ============ Multi-PHP ============ -->
   <section class="section">
     <div class="container">
@@ -172,8 +181,34 @@ <h3>🔒 Automatic HTTPS &amp; Custom Domains</h3>
     </div>
   </section>
 
-  <!-- ============ Terminal & CLI ============ -->
+  <!-- ============ Public Internet Sharing ============ -->
   <section class="section section-alt">
+    <div class="container">
+      <div class="feature-row reverse animate-in">
+        <div class="feature-content">
+          <h3>🌍 Public Internet Sharing</h3>
+          <p>
+            Need to show a local project to a client, teammate, or QA device outside your Wi-Fi network? DevBox Pro 1.0.6 adds per-project public tunnels with <strong>Cloudflare Tunnel</strong> and <strong>zrok</strong>, so you can expose a running local site without a manual deployment.
+          </p>
+          <ul>
+            <li>Per-project <strong>Share on Internet</strong> toggle in Project Details</li>
+            <li>Choose <strong>Cloudflare Tunnel</strong> or <strong>zrok</strong> as the provider</li>
+            <li>Optional <strong>Auto-start tunnel</strong> when the project starts</li>
+            <li>Works with both Nginx and Apache projects, including proxied setups</li>
+            <li>Cloudflare uses random <code>trycloudflare.com</code> URLs</li>
+            <li>zrok requires a one-time app-wide enable step in Binary Manager</li>
+          </ul>
+        </div>
+        <div class="screenshot-wrap">
+          <img src="images/pic-2.png" alt="DevBox Pro project view with project controls and sharing options">
+          <div class="screenshot-caption">Share a running project publicly without deploying it</div>
+        </div>
+      </div>
+    </div>
+  </section>
+
+  <!-- ============ Terminal & CLI ============ -->
+  <section class="section">
     <div class="container">
       <div class="section-header animate-in">
         <h2>💻 Terminal Commands</h2>
@@ -244,8 +279,8 @@ <h3>Cloud Updates</h3>
         </div>
         <div class="card">
           <div class="card-icon">🌐</div>
-          <h3>Network Sharing</h3>
-          <p>Share projects across your local network with a simple toggle. Great for testing on mobile devices or showing work to teammates.</p>
+          <h3>Local Network Sharing</h3>
+          <p>Share projects across your local network with a simple toggle. Great for testing on mobile devices or showing work to teammates on the same Wi-Fi.</p>
         </div>
         <div class="card">
           <div class="card-icon">🔗</div>

docs/getting-started.html

@@ -48,6 +48,15 @@ <h1 class="animate-in">
     </div>
   </section>
 
+  <section class="section" style="padding-top:0; padding-bottom:var(--space-2xl);">
+    <div class="container" style="max-width:900px;">
+      <div class="callout callout-warning animate-in" style="margin:0 auto;">
+        <span class="callout-icon">⚠️</span>
+        <p><strong>Usage note:</strong> DevBox Pro is intended for local development and preview sharing. It is <strong>not meant for production use</strong>, even when you expose a project with a public tunnel.</p>
+      </div>
+    </div>
+  </section>
+
   <!-- ============ System Requirements ============ -->
   <section class="section">
     <div class="container">
@@ -182,6 +191,23 @@ <h3>Open Your Project</h3>
             </p>
           </div>
         </li>
+
+        <li class="step-item animate-in">
+          <div class="step-number">6</div>
+          <div class="step-content">
+            <h3>Optional: Share It on the Internet</h3>
+            <p>
+              If you need to show the project outside your local network, download <strong>Cloudflare Tunnel</strong> or <strong>zrok</strong> from <strong>Binary Manager → Tools</strong>, then open the project detail page and enable <strong>"Share on Internet"</strong>.
+            </p>
+            <p style="margin-top:var(--space-sm);">
+              Choose a provider, optionally enable <strong>"Auto-start tunnel"</strong>, then click <strong>"Start Sharing"</strong> to get a public URL.
+            </p>
+            <div class="callout callout-warning" style="margin-top:var(--space-md);">
+              <span class="callout-icon">🌍</span>
+              <p>Use public tunnel sharing for previews, QA, and client review. It is not intended for production hosting.</p>
+            </div>
+          </div>
+        </li>
       </ol>
     </div>
   </section>

docs/guides.html

@@ -48,6 +48,15 @@ <h1 class="animate-in">
     </div>
   </section>
 
+  <section class="section" style="padding-top:0; padding-bottom:var(--space-2xl);">
+    <div class="container" style="max-width:900px;">
+      <div class="callout callout-warning animate-in" style="margin:0 auto;">
+        <span class="callout-icon">⚠️</span>
+        <p><strong>Important:</strong> DevBox Pro is built for local development workflows. Internet sharing is available for temporary previews and testing, but the app is <strong>not meant for production use</strong>.</p>
+      </div>
+    </div>
+  </section>
+
   <!-- ============ Guide: Laravel ============ -->
   <section class="section" id="guide-laravel">
     <div class="container" style="max-width:900px;">
@@ -293,6 +302,52 @@ <h3>Navigate to a project &amp; run commands</h3>
     </div>
   </section>
 
+  <!-- ============ Guide: Internet Sharing ============ -->
+  <section class="section" id="guide-internet-sharing">
+    <div class="container" style="max-width:900px;">
+      <div class="section-header animate-in">
+        <h2>🌍 Sharing a Project on the Internet</h2>
+        <p>Expose a local project publicly with Cloudflare Tunnel or zrok.</p>
+      </div>
+
+      <ol class="steps animate-in">
+        <li class="step-item">
+          <div class="step-number">1</div>
+          <div class="step-content">
+            <h3>Install a tunnel provider</h3>
+            <p>Open <strong>Binary Manager</strong>, go to <strong>Tools</strong>, and download <strong>Cloudflare Tunnel</strong> or <strong>zrok</strong>. If you choose zrok, complete the one-time app-wide enable step after installation.</p>
+          </div>
+        </li>
+        <li class="step-item">
+          <div class="step-number">2</div>
+          <div class="step-content">
+            <h3>Enable Share on Internet for the project</h3>
+            <p>Open the project detail page and toggle on <strong>"Share on Internet"</strong>. In the <strong>Public Tunnel</strong> panel, choose <strong>Cloudflare Tunnel</strong> or <strong>zrok</strong>.</p>
+          </div>
+        </li>
+        <li class="step-item">
+          <div class="step-number">3</div>
+          <div class="step-content">
+            <h3>Start the project and publish it</h3>
+            <p>Start the project if it is not already running, then click <strong>"Start Sharing"</strong>. DevBox Pro will create a public URL that you can open or send to others.</p>
+          </div>
+        </li>
+        <li class="step-item">
+          <div class="step-number">4</div>
+          <div class="step-content">
+            <h3>Use auto-start if needed</h3>
+            <p>Enable <strong>"Auto-start tunnel"</strong> if the project should automatically publish whenever it starts.</p>
+          </div>
+        </li>
+      </ol>
+
+      <div class="callout callout-warning animate-in">
+        <span class="callout-icon">⚠️</span>
+        <p><strong>Production note:</strong> Public tunnels are intended for demos, QA, stakeholder review, and short-lived previews. DevBox Pro is not a production hosting platform.</p>
+      </div>
+    </div>
+  </section>
+
   <!-- ============ Guide: Network Sharing ============ -->
   <section class="section" id="guide-sharing">
     <div class="container" style="max-width:900px;">
@@ -399,7 +454,7 @@ <h3 style="margin-bottom:var(--space-sm);">1. Overview</h3>
         <ul style="list-style:none; padding:0; margin-bottom:var(--space-lg); color:var(--text-secondary);">
           <li style="padding:4px 0;">• <strong>Web Server & PHP/Node Version:</strong> Change the assigned framework versions or switch between Nginx/Apache on the fly.</li>
           <li style="padding:4px 0;">• <strong>Services:</strong> Toggle specific databases (MySQL, PostgreSQL, MongoDB, etc.) or caching layers (Redis, Memcached) exclusively for this project.</li>
-          <li style="padding:4px 0;">• <strong>Domains & Network:</strong> Add custom domain aliases, change the document root folder, or enable <code>Share on Local Network</code> to test your app from your phone.</li>
+          <li style="padding:4px 0;">• <strong>Domains & Network:</strong> Add custom domain aliases, change the document root folder, enable <code>Share on Local Network</code>, or turn on <code>Share on Internet</code> to publish a temporary tunnel URL.</li>
         </ul>
 
         <!-- Terminal Tab -->