Repolode
Submit
open-wxa

open-wxa/wxa-runner

Runs WeChat mini-programs in a regular browser using the official WeChat base library, with Chrome DevTools debugging and Playwright E2E testing.

Open-source alternative to:WeChat Developer Tools

View on GitHubWebsite
Stars
246
Forks
21
Open issues
4
Last commit
8 hours ago

What is it?

wxa-runner runs compiled WeChat mini-program output, including native projects and uni-app or Taro builds, directly in a desktop browser. Rendering, components, setData and lifecycles run on the official WeChat base library rather than a re-implementation, so behavior is closer to a real device than an H5 version of the app.

The main use is local debugging and automated testing. Tests can be written with Playwright without remote-controlling WeChat DevTools, and they can run headless on Linux in CI. Developers can set breakpoints, inspect network requests and the DOM with Chrome DevTools, and see changes via hot reload.

The tool does not replace WeChat DevTools for preview, upload, or real-device debugging. It also supports setup hooks to preset login state, mock native APIs and intercept wx.request calls.

Key features

  • 01Runs compiled mini-program output on the official WeChat base library in the browser.
  • 02Supports native, uni-app and Taro build outputs.
  • 03Lets Playwright run E2E tests headless without WeChat DevTools.
  • 04Enables Chrome DevTools debugging with breakpoints, network and DOM inspection.
  • 05Provides hot reload on save.
  • 06Allows setup hooks to mock native APIs, intercept wx.request and preset login.

Use cases

  • Writing Playwright E2E tests for a mini-program in CI on Linux.
  • Debugging page logic and network calls with browser DevTools during development.
  • Testing flows that need mocked login or stubbed backend responses.

Quick start

  1. 1

    Run the dev server on your compiled mini-program directory

    npx wxa-runner dev ./dist/dev/mp-weixin
  2. 2

    Open the local address shown in the terminal in your browser

Things to know

  • Does not replace WeChat Developer Tools; preview, upload and real-device debugging still require it.
  • Built on the official WeChat base library, which is not covered by the project's MIT license.

Topics

#mini-program#wechat#e2e-testing#playwright#uni-app#taro#miniprogram#simulator#weapp#wechat-miniprogram

FAQ

What is wxa-runner?
Runs WeChat mini-programs in a regular browser using the official WeChat base library, with Chrome DevTools debugging and Playwright E2E testing. wxa-runner runs compiled WeChat mini-program output, including native projects and uni-app or Taro builds, directly in a desktop browser. Rendering, components, setData and lifecycles run on the official WeChat base library rather than a re-implementation, so behavior is closer to a real device than an H5 version of the app.
Is wxa-runner free to use? What license does it have?
wxa-runner is open source under the MIT license. Check the license terms before using it in commercial products.
Is wxa-runner still maintained?
Actively maintained. The last commit to wxa-runner was on Oct 21, 2026.
What can I use wxa-runner for?
Writing Playwright E2E tests for a mini-program in CI on Linux. Debugging page logic and network calls with browser DevTools during development. Testing flows that need mocked login or stubbed backend responses.
How do I install wxa-runner?
Run the dev server on your compiled mini-program directory: npx wxa-runner dev ./dist/dev/mp-weixin Open the local address shown in the terminal in your browser
Where can I get wxa-runner?
The source code and installation instructions are on GitHub: https://github.com/open-wxa/wxa-runner

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

Related projects