Download the PHP package iamdevroyal/laravel-mobile-jump without Composer

📱 Laravel Mobile Jump

Scan a QR code. See your Laravel app on your phone. Instantly.

Mobile Jump bridges the gap between your local Laravel development server and any Android device on the same Wi-Fi network. Run one command, scan a QR code with the companion app, and your phone loads your local Vue or React frontend in seconds — with hot module replacement, API access, and a full native bridge for camera, microphone, location, biometrics, and more.

No tunnelling services. No internet required. No configuration headaches.

✨ Features

📋 Requirements

• PHP 8.2+
• Laravel 11.x, 12.x, or 13.x
• Android phone on the same Wi-Fi network as your laptop
• One of: Redis (recommended), MySQL/SQLite, or a writable filesystem
• Vite (Vue/React frontend) configured to listen on 0.0.0.0 — see Frontend Setup

🚀 Installation

Step 1 — Install via Composer

The service provider is auto-discovered — no manual registration needed.

Step 2 — Run the Install Wizard

The wizard will:

• ✅ Publish config/mobile-jump.php
• ✅ Copy the companion Android APK to public/vendor/mobile-jump/MobileJump.apk
• ✅ Check your configured storage backend (Redis / Database / File)
• ✅ Optionally scaffold a Vue 3 or React frontend stub
• ✅ Automatically patch your package.json dev script and vite.config.js to bind to 0.0.0.0

Step 3 — (Optional) Database Migration

Only needed if MOBILE_JUMP_STORAGE=database:

🛠 Frontend Setup (Required)

Mobile Jump needs your Vite dev server to listen on all network interfaces so your Android device can reach it over Wi-Fi.

Note: The install wizard (php artisan mobile:jump:install) attempts to do this automatically. Only follow these manual steps if you skipped the wizard or see Frontend not reachable warnings.

Vue 3 / Vite

Option A — vite.config.js (recommended):

Add a server block to your vite.config.js:

Then simply run:

Option B — package.json dev script:

Update your package.json to include --host:

⚠️ PowerShell users: Do NOT use npm run dev -- --host 0.0.0.0. PowerShell passes 0.0.0.0 as a positional argument (root directory) rather than a --host value. Use one of the options above instead.

React / Vite

Same as Vue — add server.host: '0.0.0.0' to your vite.config.js:

Next.js (React)

Next.js uses its own server. Run it with:

Then set MOBILE_JUMP_FRONTEND_PORT=3000 in your .env.

⚡ Avoiding "Axios Network Error" on Mobile Devices

When testing on an Android device via Mobile Jump, your web app loads at http://<your-lan-ip>:5173. If your API client hardcodes http://127.0.0.1:8000 or reads a .env file containing VITE_API_URL=http://127.0.0.1:8000, the mobile device will try to send API requests to 127.0.0.1:8000 (which points to the phone itself), causing an Axios Network Error.

Solution 1 — Dynamic API Base URL Helper

In your primary API client file (e.g. src/api/client.js):

Solution 2 — Dynamic Reverb / WebSockets Host

In your Echo / Reverb composable (e.g. src/composables/useReverb.js):

🎯 Usage

Start a Development Session

Requires Vite configured for host: '0.0.0.0' — see Frontend Setup above.

A compact QR code renders in your terminal. You'll see something like:

Command Options

Browser Dashboard

Open the URL shown in the terminal banner, or navigate directly to:

The dashboard shows live session status, connection time, device info, and a button to disconnect the session.

📱 Android Companion App

The companion APK is bundled directly in the package. After installation it is copied to:

Transfer it to your phone:

• Share the file via Bluetooth, USB, or serve it locally: http://<your-lan-ip>:8000/vendor/mobile-jump/MobileJump.apk
• Install it (allow "Install from unknown sources" in Android settings)

On first launch, the app requests:

• Camera (for QR scanning and live capture)
• Microphone (for voice recording)
• Location (for geolocation sharing)

⚙️ Configuration

Publish the config file:

config/mobile-jump.php:

Environment Variables

Add these to your .env as needed:

🌐 Frontend Integration

Vue 3

After running php artisan mobile:jump:install and choosing Vue, stubs are placed in vendor-stubs/mobile-jump/. Copy them to your project:

React / TypeScript

Direct Bridge Access (Any Framework)

The companion app exposes a native bridge on window.MobileJumpNative:

🔐 Native Bridge — Full Reference

All methods available at window.MobileJumpNative (also aliased as window.KorpaBeeNative):

Device & Platform

Permissions

Location

Biometrics

Native UI

Clipboard

Haptics

Diagnostics

Persistent Storage

🔌 API Endpoints

All endpoints are prefixed with the configured route_prefix (default: mobile-jump).

🧪 Testing

Run the included test suite:

The tests use Orchestra Testbench and the File session store — no Redis or database needed to run tests.

🛠️ How It Works

📦 Changelog

See CHANGELOG.md for release history.

🤝 Contributing

Contributions, issues, and feature requests are welcome. Please open an issue first to discuss major changes.

📄 License

MIT — see LICENSE.

🙏 Credits

Built by iamdevroyal.

Inspired by the need to preview complex Laravel + Vue apps on real Android devices during development — without the overhead of cloud tunnels, staging environments, or APK rebuilds.

u{1F4F1} Android App Repository

The companion Android app source code lives in its own repository:

iamdevroyal/android-mobile-jump