Mobile Frontend

Getting started

Node.js 22.23.4 and pnpm are required to run the project. Enable corepack so the repo packageManager field can activate pnpm.

System Requirements

Required Node.js Version: 22.23.4 (2026-10-21 security release). If your current version differs, follow the steps below to switch

nvm install 22.23.4
nvm use 22.23.4
corepack enable
corepack prepare pnpm@9.15.9 --activate

Installation

cd ECShopX_mobile-frontend
pnpm install

Configure the .env file

# Backend API Base URL
APP_BASE_URL=
  
# WebSocket Endpoint
APP_WEBSOCKET=

# System Tenant ID
APP_COMPANY_ID=1

# System Business Model (b2c:standard/b2b2c:platform)
APP_PLATFORM=standard
  
# H5 domain of the mobile web app, used for payment result callbacks.
APP_CUSTOM_SERVER=

# App Homepage Path
APP_HOME_PAGE=/pages/index

# WeChat Mini Program AppID，required for compiling the mini program
APP_ID=wx1e25e45145b70faa

# Map Service API Key, used for geocoding user LBS coordinates and providing location-based offline store recommendations.
APP_MAP_KEY=

# Mapping Service Provider Name
APP_MAP_NAME=

# Media files OSS Server URL
APP_IMAGE_CDN=

# Store Operations Tool Domain Address
APP_DIANWU_URL=

# Merchant Portal Domain Address
APP_MERCHANT_URL=

# Payment Callback URL for Third-Party Payment Platforms
APP_ADAPAY=

Cloud Deployment: Backend API Base URL

When deploying to a server or cloud host, requests fail until APP_BASE_URL points at your own backend instead of the default.

• Which variable / file? Set APP_BASE_URL in .env, or in .env.local which overrides .env.
• Do I need the port? Only when the backend is reached directly on a non-standard port — the PHP API listens on 8005 by default. Behind a domain proxied by Nginx on 80/443, omit the port.
• Rebuild after every change. APP_* variables are baked in at build time. After editing the env file you must re-run the build. Run it from the project root (where package.json lives); inside a container, run it in that same directory.

# Behind a domain (Nginx on 80/443) — no port needed, end with /api
APP_BASE_URL=https://your-domain.com/api
# Direct public IP on a non-standard port — include the port
APP_BASE_URL=http://1.2.3.4:8005/api

# Rebuild after changing the value
pnpm run build:h5      # Mobile Web App (H5)
pnpm run build:weapp   # WeChat Mini Program

Run project

# Compile Mobile Web App
pnpm run dev:h5

# Compile WeChat Mini Program
pnpm run dev:weapp

Build packages

# Compile Mobile Web App
pnpm run build:h5

# Compile WeChat Mini Program
pnpm run build:weapp

License

Each ECShopX source file included in this distribution is licensed under the Apache License 2.0, together with the additional terms imposed by ShopeX.

Open Software License (Apache 2.0) – Please see LICENSE.txt for the full text of the Apache 2.0 license.

每个包含在本发行版中的 ECShopX 源文件，均依据 Apache 2.0 开源许可证与ShopeX商派附加条款进行授权。

开源软件许可协议（Apache 2.0） —— 请参阅 LICENSE.txt 文件以获取 Apache 2.0 协议的完整文本。