Skip to content

Add WebSocket bridge for Jump with multi-device support #92

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
shanerbaner82 wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Add WebSocket bridge for Jump with multi-device support #92

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
20c29d9
Add WebSocket bridge server for Jump with multi-device support
shanerbaner82 Apr 11, 2026
6d2697f
Add deep link QR code and terminal QR display for Jump
shanerbaner82 Apr 13, 2026
08e94a9
Add /jump/open redirect endpoint and platform instructions
shanerbaner82 Apr 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
211 changes: 169 additions & 42 deletions resources/jump/router.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,24 +9,23 @@
* to handle Jump server requests without requiring Workerman.
*
* Configuration is passed via environment variables:
* - JUMP_ZIP_PATH: Path to the app.zip bundle
* - JUMP_DISPLAY_HOST: The host IP to display in QR code
* - JUMP_HTTP_PORT: The HTTP port the server is running on
* - JUMP_LARAVEL_PORT: The Laravel dev server port to proxy to
* - JUMP_BASE_PATH: The Laravel base path for autoloading
* - JUMP_WS_PORT: The WebSocket bridge port
* - JUMP_VITE_PORT: The Vite dev server port
*/

// Suppress all error output to prevent corrupting binary responses
error_reporting(0);
ini_set('display_errors', '0');

// Get configuration from environment
$zipPath = getenv('JUMP_ZIP_PATH');
$displayHost = getenv('JUMP_DISPLAY_HOST');
$httpPort = getenv('JUMP_HTTP_PORT');
$laravelPort = getenv('JUMP_LARAVEL_PORT') ?: 8000;
$basePath = getenv('JUMP_BASE_PATH');
$offlineMode = getenv('JUMP_OFFLINE_MODE') === '1';

// Parse request FIRST - before loading any autoloaders
$uri = $_SERVER['REQUEST_URI'];
Expand Down Expand Up @@ -81,44 +80,49 @@ function jumpLog($message)
exit;
}

// Handle ZIP download endpoint
if ($path === '/jump/download') {
if (! $zipPath || ! file_exists($zipPath)) {
http_response_code(500);
echo 'App bundle not available. Please restart the server.';
exit;
}

$userAgent = $_SERVER['HTTP_USER_AGENT'] ?? 'unknown';
$deviceName = parseDeviceName($userAgent);
$fileSizeBytes = filesize($zipPath);
$fileSize = formatBytes($fileSizeBytes);
jumpLog("{$deviceName} downloading ({$fileSize})");

// Clean ALL output buffers
while (ob_get_level()) {
ob_end_clean();
}

// Minimal headers - match what Workerman's withFile() sends
header('Content-Type: application/zip');
header('Content-Length: '.$fileSizeBytes);
header('Content-Disposition: attachment; filename="app.zip"');

// Use readfile - simplest approach
readfile($zipPath);
// Handle deep link redirect — camera scans HTTP URL, browser redirects to jump:// app
if ($path === '/jump/open') {
$deepLink = "jump://connect?host={$displayHost}&port={$httpPort}";
$appName = getenv('APP_NAME') ?: 'Laravel';
header('Content-Type: text/html; charset=UTF-8');
echo <<<HTML
<!DOCTYPE html>
<html><head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Opening {$appName} in Jump...</title>
<script>window.location.href = "{$deepLink}";</script>
</head><body style="font-family:system-ui;display:flex;align-items:center;justify-content:center;height:100vh;margin:0;background:#111;color:#fff;text-align:center">
<div>
<h2>Opening in Jump...</h2>
<p style="color:#888">If the app doesn't open, <a href="{$deepLink}" style="color:#8B5CF6">tap here</a>.</p>
<p style="color:#666;font-size:14px;margin-top:24px">Don't have Jump? <a href="https://apps.apple.com/app/jump/id6738194400" style="color:#8B5CF6">Download for iOS</a></p>
</div>
</body></html>
HTML;
exit;
}

// Handle info endpoint
if ($path === '/jump/info') {
header('Content-Type: application/json');
echo json_encode([

// Get WebSocket port from environment (set by JumpCommand)
$wsPort = getenv('JUMP_WS_PORT') ?: null;

$info = [
'name' => 'NativePHP Server',
'app_name' => getenv('APP_NAME') ?: 'Laravel',
'version' => '1.0.0',
'type' => 'nativephp-server',
]);
];

// Include WebSocket port for hybrid mode
if ($wsPort) {
$info['ws_port'] = (string) $wsPort;
}

echo json_encode($info);
exit;
}

Expand All @@ -137,11 +141,9 @@ function jumpLog($message)

$appName = getenv('APP_NAME') ?: 'Laravel';

// Create JSON data for the QR code
$qrData = json_encode([
'host' => $displayHost,
'port' => (string) $httpPort,
]);
// Create deep link URL for the QR code
// jump:// scheme opens the Jump app directly when scanned with the camera
$qrData = "jump://connect?host={$displayHost}&port={$httpPort}";

// Generate QR code
$result = (new Builder(
Expand All @@ -152,10 +154,8 @@ function jumpLog($message)

$qrCodeDataUri = $result->getDataUri();

// Generate HTML - use offline version if flag is set
global $offlineMode;
$viewFile = $offlineMode ? 'qr-offline.blade.php' : 'qr.blade.php';
$viewPath = __DIR__.'/views/'.$viewFile;
// Generate HTML
$viewPath = __DIR__.'/views/qr.blade.php';

if (file_exists($viewPath)) {
// Read blade file and do simple variable substitution
Expand All @@ -179,6 +179,33 @@ function jumpLog($message)
}
}

// Proxy Vite dev server requests (HMR, assets, websocket)
// Vite paths: /@vite/, /@fs/, /@id/, /resources/ (dev assets), hot-update files
$hotFilePath = $basePath.'/public/hot';
$viteRunning = file_exists($hotFilePath);
// Read the actual Vite dev server URL from the hot file (e.g. "http://[::1]:5174")
$vitePort = 5173;
if ($viteRunning) {
$hotContent = trim(file_get_contents($hotFilePath));
if (preg_match('/:(\d+)\/?$/', $hotContent, $m)) {
$vitePort = (int) $m[1];
}
}

if ($viteRunning) {
$isViteRequest = str_starts_with($path, '/@vite')
|| str_starts_with($path, '/@fs')
|| str_starts_with($path, '/@id')
|| str_starts_with($path, '/resources/')
|| str_starts_with($path, '/node_modules/')
|| str_contains($path, '.hot-update.');

if ($isViteRequest) {
proxyToVite($vitePort);
exit;
}
}

// Proxy all other requests to Laravel
proxyToLaravel($laravelPort);

Expand Down Expand Up @@ -883,6 +910,75 @@ function generateQrHtml($appName, $qrCodeDataUri, $displayHost, $port)
HTML;
}

/**
* Proxy request to Vite dev server
*/
function proxyToVite($vitePort)
{
$method = $_SERVER['REQUEST_METHOD'];
$uri = $_SERVER['REQUEST_URI'];

// Try the hot file origin first (may be IPv6 [::1]), fall back to 127.0.0.1
global $hotFilePath;
$viteHost = "http://127.0.0.1:{$vitePort}";
if (isset($hotFilePath) && file_exists($hotFilePath)) {
$viteHost = rtrim(trim(file_get_contents($hotFilePath)), '/');
}
$viteUrl = "{$viteHost}{$uri}";

$headers = [];
foreach ($_SERVER as $key => $value) {
if (strpos($key, 'HTTP_') === 0) {
$headerName = str_replace('_', '-', substr($key, 5));
if (in_array(strtolower($headerName), ['connection', 'keep-alive', 'transfer-encoding', 'upgrade', 'host'])) {
continue;
}
$headers[] = "{$headerName}: {$value}";
}
}
if (isset($_SERVER['CONTENT_TYPE'])) {
$headers[] = 'Content-Type: '.$_SERVER['CONTENT_TYPE'];
}

$ch = curl_init($viteUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
curl_close($ch);

if ($response === false) {
http_response_code(502);
echo 'Vite dev server not reachable on port '.$vitePort;

return;
}

$responseHeaders = substr($response, 0, $headerSize);
$responseBody = substr($response, $headerSize);

http_response_code($httpCode);

$headerLines = explode("\r\n", $responseHeaders);
foreach ($headerLines as $headerLine) {
if (empty($headerLine) || strpos($headerLine, 'HTTP/') === 0) {
continue;
}
if (stripos($headerLine, 'transfer-encoding:') === 0) {
continue;
}
header($headerLine);
}

echo $responseBody;
}

/**
* Proxy request to Laravel development server
*/
Expand All @@ -893,6 +989,7 @@ function proxyToLaravel($laravelPort)
$laravelUrl = "http://127.0.0.1:{$laravelPort}{$uri}";

// Build headers to forward
global $displayHost, $httpPort;
$headers = [];
foreach ($_SERVER as $key => $value) {
if (strpos($key, 'HTTP_') === 0) {
Expand All @@ -908,6 +1005,12 @@ function proxyToLaravel($laravelPort)
$headers[] = 'Content-Type: '.$_SERVER['CONTENT_TYPE'];
}

// Tell Laravel the real host so it generates correct URLs (redirects, assets, etc.)
$headers[] = "Host: {$displayHost}:{$httpPort}";
$headers[] = "X-Forwarded-Host: {$displayHost}:{$httpPort}";
$headers[] = 'X-Forwarded-Proto: http';
$headers[] = 'X-Forwarded-Port: '.$httpPort;

// Get request body for POST/PUT/PATCH
$body = null;
if (in_array($method, ['POST', 'PUT', 'PATCH'])) {
Expand Down Expand Up @@ -948,7 +1051,10 @@ function proxyToLaravel($laravelPort)
// Set response code
http_response_code($httpCode);

// Forward response headers (skip some)
$laravelOrigin = "http://127.0.0.1:{$laravelPort}";
$jumpOrigin = "http://{$displayHost}:{$httpPort}";

// Forward response headers, rewriting any redirect URLs
$headerLines = explode("\r\n", $responseHeaders);
foreach ($headerLines as $headerLine) {
if (empty($headerLine) || strpos($headerLine, 'HTTP/') === 0) {
Expand All @@ -958,9 +1064,30 @@ function proxyToLaravel($laravelPort)
if (stripos($headerLine, 'transfer-encoding:') === 0) {
continue;
}
// Rewrite Location headers that still point to Laravel's internal address
if (stripos($headerLine, 'location:') === 0) {
$headerLine = str_replace($laravelOrigin, $jumpOrigin, $headerLine);
}
header($headerLine);
}

// Output response body
// Rewrite Vite dev server URLs so the phone routes them through the Jump proxy.
// Vite can generate URLs with localhost, 127.0.0.1, [::], or the network IP.
global $vitePort;
if ($vitePort) {
$viteOrigins = [
"http://localhost:{$vitePort}",
"http://127.0.0.1:{$vitePort}",
"http://[::1]:{$vitePort}",
"http://[::]:{$vitePort}",
"http://{$displayHost}:{$vitePort}",
];
$responseBody = str_replace(
$viteOrigins,
"http://{$displayHost}:{$httpPort}",
$responseBody
);
}

echo $responseBody;
}
Loading
Loading