zmp-cli

ZMP CLI

ZMP command line utility makes easier to create Zalo Mini Program (ZMP). CLI the most recommended way to start ZMP app development.

Guide

• Features
• Installation
• Usage
• Configuration
• APIs

Features

• Create a Zalo Mini Program with React Framework.
• Deploy the mini program to Zalo Server.

Installation

Install zmp-cli (may require "sudo"):

$ npm install -g zmp-cli

Usage

Run the following command to get usage helps:

$ zmp

Directly:

$ zmp <command> [options]

Create Zalo APP

1. Open Zalo for Developers and login with Zalo account.
2. Create new app with following step:
   1. Click on your avatar and choose Thêm ứng dụng mới
   2. Input your app information.
   3. Click Tạo ID ứng dụng
3. Active your app

Get Zalo APP Access Token

1. Open Zalo for Developers and login with Zalo account.
2. On Navigation Bar, choose Công cụ -> API Explorer
3. On API Explorer, select your app and click Lấy User Access Token

Create ZMP

To create ZMP app, create a Zalo app and run the following command in the directory where you want to create app:

$ mkdir mini-app && cd mini-app
$ zmp create

Program will prompt for few questions about Zalo App ID, Zalo access token, framework and template you want to start with.

Create ZMP with user interface

Run the following command in the directory where you want to create app:

$ zmp create --ui

It will launch UI where you will be able to configure the project. By default it launches server on localhost:3001 address. If you want to change the port then use --port <n> argument:

$ zmp create --ui --port 8080

Start ZMP

$ zmp start

Deploy ZMP

$ zmp deploy

To open your app, you must use Zalo App to scan QR code after deploy done

Configuration

Change file app.json to config your app when it is launched.

Example:

{
  "window": {
    "titleHeader": "My App",
    "orientation": 0,
    "color": "#15A6FB",
    "rightMenu": {
      "data": [],
      "supportToolBar": 0,
      "reset": 0
    },
    "leftMenu": {
      "buttonType": 1,
      "confirmToExit": 1,
      "dialogMessage": "Bạn có muốn đóng app này không?"
    }
  },
  "debug": false
}

APIs

View APIs