Skip to content

Quick Start ​

Here, we create a Vona project and a Zova project and combine them to create a complete fullstack development environment.

Create a Vona project ​

Create a Vona project using the cabloy-basic template.

bash
$ vona :create:project projectName --template=cabloy-basic
$ cd projectName

The cabloy-basic template has a built-in suite vona-suite-cabloy-basic, which contains the following modules:

namedescription
basic-siteadminUsed to implement Admin

Create a Zova project ​

1. Clone the Zova source code ​

bash
$ git clone --depth 1 https://github.com/zovajs/zova.git
$ cd zova

2. Initialize and install dependencies ​

bash
$ npm run init

3. Enter the zova-dev directory ​

bash
$ cd zova-dev

4. Modify the .env file ​

env/.env.ssr.cabloyBasicAdmin:

bash
BUILD_COPY_RELEASE = /path-to-vona/src/suite/cabloy-basic/modules/basic-siteadmin/assets/site
BUILD_REST_COPY_DIST = /path-to-vona/src/suite/cabloy-basic/modules/basic-siteadmin/zovaRest
NameDescription
BUILD_COPY_RELEASEAutomatically copy the built JS bundle to Vona
BUILD_REST_COPY_DISTAutomatically copy the built type files to Vona

5. Build the Zova project ​

  • Build JS bundle
bash
$ npm run build:ssr:cabloyBasicAdmin
  • Build type files
bash
$ npm run build:rest:cabloyBasicAdmin

Run the project ​

1. Start Vona development server ​

bash
$ npm run dev
URLDescription
http://localhost:7102Admin

2. Start Zova development server ​

You can directly start Zova development server to debug the frontend code. At this point, Vona can be accessed by the frontend as an API service.

bash
$ npm run dev:ssr:cabloyBasicAdmin
URLDescription
http://localhost:9000Admin

Released under the MIT License.