Repolode
Submit
HuolalaTech

HuolalaTech/page-spy-web

A self-hostable remote debugging web client that shows console output and data from pages running on remote devices, paired with the PageSpy SDKs.

View on GitHubWebsite
Stars
5,635
Forks
357
Open issues
53
Last commit
2 months ago

What is it?

PageSpy is a remote debugging tool for web pages, React Native apps, mini programs and HarmonyOS apps. Client-side SDKs wrap native console and related APIs, serialize the arguments, and send them to a debugging client, which displays them in an interface similar to a local browser devtools console.

This repository is the web client and server side of that system. It can be run locally with Node.js via the @huolala-tech/page-spy-api package, or deployed with Docker, which exposes the service on port 6752. Logs and data are stored under the mounted directories, so the service can be kept on your own infrastructure.

The project targets cases where local devtools are unavailable, such as debugging inside a mobile webview, coordinating bug reproduction across regions, or finding the cause of a white screen on an end user's device.

Key features

  • 01Wraps native console and related APIs in SDKs for web, React Native, mini programs and HarmonyOS.
  • 02Displays remote logs in an interface similar to a local devtools console.
  • 03Deploys with Node.js via npm or with Docker on port 6752.
  • 04Keeps logs and data on your own server.

Use cases

  • Debugging an H5 page or webview on a phone where local devtools are hard to use.
  • Helping a remote team member reproduce and inspect a bug across regions.
  • Investigating a white screen reported from an end user's device.

Quick start

  1. 1

    Install the API service globally with npm or yarn

    npm install -g @huolala-tech/page-spy-api@latest
  2. 2

    Start the service in the terminal

    page-spy-api
  3. 3

    Open the client in your browser at localhost port 6752

Things to know

  • Self-hosting requires running a Node.js service or Docker container yourself.
  • Remote debugging requires adding the matching PageSpy SDK to the page or app being debugged.

In collections

Self-hosted apps

Topics

#remote-debugging#console#devtools#webview#self-hosted#javascript#mini-program#debugger#remote-control

FAQ

What is page-spy-web?
A self-hostable remote debugging web client that shows console output and data from pages running on remote devices, paired with the PageSpy SDKs. PageSpy is a remote debugging tool for web pages, React Native apps, mini programs and HarmonyOS apps. Client-side SDKs wrap native console and related APIs, serialize the arguments, and send them to a debugging client, which displays them in an interface similar to a local browser devtools console.
Is page-spy-web free to use? What license does it have?
page-spy-web is open source under the MIT license. Check the license terms before using it in commercial products.
Is page-spy-web still maintained?
Updated within 6 months. The last commit to page-spy-web was on Sep 18, 2026.
What can I use page-spy-web for?
Debugging an H5 page or webview on a phone where local devtools are hard to use. Helping a remote team member reproduce and inspect a bug across regions. Investigating a white screen reported from an end user's device.
How do I install page-spy-web?
Install the API service globally with npm or yarn: npm install -g @huolala-tech/page-spy-api@latest Start the service in the terminal: page-spy-api Open the client in your browser at localhost port 6752
Where can I get page-spy-web?
The source code and installation instructions are on GitHub: https://github.com/HuolalaTech/page-spy-web

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects