HacoeurHacoeur

April 19, 2025

phonehost

PhoneHost

PhoneHost is an open-source CLI tool that lets you preview your localhost website on a mobile device in seconds. It generates a QR code for easy access over local Wi-Fi and supports public tunnels for different networks.

Contact :adil@hacoeur.dev

Git :https://github.com/hacoeur-24/PhoneHost

Links

## About PhoneHost PhoneHost is an open-source CLI tool designed for developers who need to test their websites on real mobile devices — quickly and effortlessly. Your localhost is now on your phone with a single command. ### The Problem Responsive web development often requires testing on real mobile devices, not just browser DevTools. But setting up a way to preview your localhost on your phone can be frustrating — USB debugging, emulators, or complicated network configurations. PhoneHost eliminates that pain entirely. ### How It Works PhoneHost detects your machine's local IP address and generates a QR code right in your terminal. Simply scan it with your phone, and your local development site appears on your mobile browser — instantly. When your devices aren't on the same network, PhoneHost can create a secure public tunnel using LocalTunnel or Cloudflare, giving you a shareable URL that works from anywhere. ### Key Features - **QR Code Access** — Scan and preview your site on mobile in seconds - **Auto Port Detection** — Automatically finds your running dev server - **Public Tunneling** — Access your localhost from any network via LocalTunnel or Cloudflare - **Clipboard Copy** — Quickly copy the generated URL to share it - **Zero Configuration** — Works out of the box, no setup needed - **Lightweight** — Minimal footprint, runs instantly ### Works With Everything PhoneHost is compatible with any tool that runs a local development server — Next.js, Vite, React, Vue, Svelte, Angular, Astro, and more. If it runs on localhost, PhoneHost can share it to your phone. ### Built With Node.js, TypeScript, Commander.js, Chalk, Clipboardy, LocalTunnel, Cloudflare, and qrcode-terminal. ### Open Source PhoneHost is fully open source under the MIT license. Contributions, issues, and feedback are welcome on GitHub.