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.