Free developer app · Runs on your phone

Run your web project on your phone, without rebuilding

The html2app developer app is a free phone app that loads the dev server running on your computer. Save a file, and the change shows up on your device through live reload. Build your own copy on html2app.dev and it includes the plugins you select.

  • No rebuild per change
  • Stays on your local network
  • Console logs in your terminal
Why it saves time

Stop rebuilding for every small change

Testing a native app usually means a new cloud build, a download and a reinstall after each edit. The developer app skips that loop. The phone loads your files straight from your computer.

Usual build loop

Every change waits for a cloud build and a reinstall.

  1. Edit
  2. Cloud build
  3. Download
  4. Reinstall
  5. Test
Developer app loop

Every save reloads the page on your phone.

  1. Edit
  2. Save
  3. Phone reloads
  4. Test

Real device, real plugins

Plugin calls run on your phone, so you see the real result on real hardware.

Edit, save, see

Live reload sends each saved change to the device. You stay in your editor the whole time.

Debug from the terminal

Remote logs send console output from the phone to your terminal, which helps when a plugin call fails.

Setup

Four steps from your project to your phone

Start a local server on your computer, then connect the developer app on your phone.

  • A code editor, such as VS Code
  • Node.js LTS, which includes npx
  • Phone and computer on the same Wi-Fi
  1. 1

    Start the server from your project folder

    If index.html sits at the top level of the folder, run this command.

    bash
    $ npx -y five-server@latest --host=0.0.0.0 --remoteLogs=true
  2. 2

    Point the root at a subfolder if you need to

    If index.html lives inside a folder such as www, serve that folder instead.

    bash
    $ npx -y five-server@latest --root=www --host=0.0.0.0 --remoteLogs=true
  3. 3

    Copy the network address

    The terminal prints a local URL and a network URL, for example http://192.168.1.20:5500. Use the network URL. The port is not always 5500.

  4. 4

    Connect from the developer app

    Open the developer app on your phone, enter the address without http://, for example 192.168.1.20:5500, and tap Connect. The app adds the protocol for you.

What the command options do

-y
Lets npx install five-server without asking for confirmation.
five-server@latest
Always runs the newest published version.
--root=www
Serves a subfolder. Only needed when index.html is not at the top level.
--host=0.0.0.0
Lets other devices on your network connect. Without it, only your computer can.
--remoteLogs=true
Prints console output from your phone in the terminal.

Press Ctrl+C in the terminal to stop the server.

Configure your build

Build a developer app with the plugins you need

The developer app on GitHub is the free shell. Build your own copy on html2app.dev and it includes only the plugins you select. Your phone tests then match the app you ship.

  1. 01

    Get the project ZIP

    Zip your project folder, or on the developer-app repository click Code, then Download ZIP.

  2. 02

    Upload it to html2app.dev

    Upload the ZIP on html2app.dev. Sign in to the dashboard if prompted.

  3. 03

    Add your plugins

    On the Plugins page, click Add New Plugin, select the plugins you need and configure them.

  4. 04

    Build and install

    Start the build, then follow the instructions on the site to install the app on your phone.

Plugin picker Demo 2 selected
Included in your build

AdMob, Vibration

Camera is Android only for now. This picker only demonstrates the choice. Pick your real plugins on the Plugins page on html2app.dev.

app.js Use a plugin
import { Vibration } from '@yandeu/js-bridge/lib/plugins/vibration.js'

// Buzz once (500ms)
Vibration.vibrate()

// Custom pattern: [wait, buzz, wait, buzz]
await Vibration.vibrateWithPattern([0, 500, 100, 500])

Save the file, and the developer app reloads it on your phone. Plugin calls only work when the plugin is in your build.

Live reload and remote logs

Save in your editor, check the result on the phone

Both features run on the server you started on your computer.

Live reload

When you save a file, the page on your phone reloads with the new code.

The page reloads from scratch, so temporary state in your app resets.

Remote logs

Add --remoteLogs=true to your command. Console output from the phone prints in your terminal while you test plugin calls.

app.js Build v1 Vibrate
remote logs
  • Remote logs are on. Waiting for your phone…
Demo. Each click mimics a save and its log output.
Troubleshooting

Common questions

The phone cannot reach the address. What now?

Check that the phone and the computer share the same Wi-Fi, since guest networks often block this. Allow Node.js through your firewall on private networks. Use the network URL from the terminal, and confirm the port matches the one printed there.

Is --host=0.0.0.0 safe?

It makes your project files reachable by every device on the same network. Use it only on networks you trust, and stop the server when you finish.

Does my code leave my computer?

No. The developer app connects straight to your local server over your local network. No source code or credentials are saved or sent to cloud servers.

What does the developer app store on my phone?

Up to 10 recent addresses, kept in the app's local storage. Use Clear All in the app to remove them.

Why are some files missing on the phone?

Files whose names start with a dot, such as .env, are not served by default.

Build the developer app with your plugins

Pick your plugins on html2app.dev, then test them on your phone with live reload and remote logs.