Cross-Platform Apps
DaxPay provides three uni-app clients: the admin app, merchant app, and cashier mini-program. They share the unibest 4, Vue 3.4, pnpm, and uni CLI workflow, but their supported targets differ.
The source repositories are distributed through authorized channels. See Build - Source for details.
Platform Matrix
| Client | H5 | Alipay | Douyin | App | |
|---|---|---|---|---|---|
Admin dax-pay-app-admin | Yes, port 9000 | Yes | Yes | Yes | Android / iOS |
Merchant dax-pay-app-merchant | Yes, port 9100 | Yes | Yes | Yes | Android / iOS |
Cashier dax-pay-cashier | No | Yes | Yes | Yes | No |
Output and Tools
Non-H5 uni-app targets produce compiled directories. Keep the development command running and open the output directory with the matching tool.
| Target | Development output | Build output | Tool |
|---|---|---|---|
| H5 | Development server | dist/build/h5/ | Browser or static server |
dist/dev/mp-weixin/ | dist/build/mp-weixin/ | WeChat DevTools | |
| Alipay | dist/dev/mp-alipay/ | dist/build/mp-alipay/ | Alipay Mini Program IDE |
| Douyin | dist/dev/mp-toutiao/ | dist/build/mp-toutiao/ | Douyin DevTools |
| App | dist/dev/app/ | dist/build/app/ | HBuilderX |
Environment
Each client reads environment files from its env/ directory:
VITE_SERVER_BASEURL = 'http://127.0.0.1:9999'For a physical device, use a LAN IP address or a publicly reachable hostname instead of 127.0.0.1.
The admin and merchant H5 ports are 9000 and 9100. Mini-program and App builds do not use a local development-server port.
Mini-Program Development
For the admin or merchant client:
cd dax-pay-app-admin # or dax-pay-app-merchant
pnpm install
pnpm run dev:mpImport dist/dev/mp-weixin/ into WeChat DevTools. Other mini-program targets use:
pnpm run dev:mp-alipay
pnpm run dev:mp-toutiaoThe cashier client uses the same target commands from dax-pay-cashier. Its pnpm run dev command defaults to WeChat.
H5 Development
Only the admin and merchant clients support uni-app H5:
pnpm run dev:h5Use port 9000 for the admin client and 9100 for the merchant client.
App Development
Only the admin and merchant clients support App targets:
cd dax-pay-app-admin # or dax-pay-app-merchant
pnpm install
pnpm run dev:appImport dist/dev/app/ into HBuilderX and run it on an Android emulator, Android device, or iOS base. App development does not use mini-program developer tools.
If Android hot reload does not work when importing
dist/dev/app/, import the complete uni-app project into HBuilderX as described in the unibest App guide. The generated directory workflow is suitable for the standard iOS flow.
Building
Admin and merchant builds:
pnpm run build:h5
pnpm run build:mp-weixin
pnpm run build:mp-alipay
pnpm run build:mp-toutiao
pnpm run build:appImport mini-program output from dist/build/<platform>/ into the corresponding IDE. Import dist/build/app/ into HBuilderX and use native App cloud packaging or local packaging.
The cashier client supports only:
pnpm run build:mp-weixin
pnpm run build:mp-alipay
pnpm run build:mp-toutiao