Zova CLI Frontend Project Template Provisioner

1.2.34 · active · verified Wed Apr 22

The `zova-cli-set-front` package is an internal component of the Zova CLI, a command-line interface designed to streamline the development of applications using the Zova framework. Zova itself is a modern TypeScript-first framework (current stable version 1.2.34) that integrates development paradigms from Vue3, React, and Angular, aiming to provide an intuitive and efficient experience for building SSR/SPA/Website/Admin-Dashboard applications. This particular CLI component is responsible for provisioning frontend project templates, allowing developers to quickly scaffold new Zova projects with popular UI libraries like Ant Design Vue (antdv), Element Plus, Quasar, or Vuetify, as well as an empty template for custom setups. It abstracts away initial configuration, focusing on enabling developers to immediately start building their applications within the Zova ecosystem. The framework emphasizes modularization, an Inversion of Control (IOC) container, built-in Server-Side Rendering (SSR), and a refined reactivity system that avoids common Vue.js `ref`/`reactive` boilerplate. While a specific release cadence for individual CLI components is not explicitly stated, the overarching Zova project appears to be under active development and maintenance.

Common errors

```
zova :create:project: command not found
```
cause The Zova CLI is either not installed globally, or it's not in your system's PATH. Alternatively, you might be using `npm` or `yarn` instead of `pnpm` for global installation.

fix Ensure `zova-cli` is installed globally using `pnpm`: `pnpm add -g zova-cli@latest`. Verify `pnpm`'s global bin directory is in your system's PATH.
```
Error: Node.js version unsupported. Zova CLI requires Node.js >=24.8.0
```
cause Your current Node.js version is older than the minimum requirement specified by Zova CLI.

fix Update your Node.js installation to version 24.8.0 or newer. Consider using a version manager like `nvm` (Node Version Manager) for easy switching: `nvm install 24` then `nvm use 24`.

Warnings

breaking Zova CLI has strict Node.js and pnpm version requirements. Using unsupported versions may lead to installation failures or unexpected behavior.
Fix: Ensure Node.js is >=24.8.0 and pnpm is >=10.19.0. Update your Node.js and pnpm installations if necessary.
gotcha The Zova CLI uses a non-standard command syntax with colons (e.g., `:create:project`). Incorrect command formatting will result in 'command not found' errors.
Fix: Always refer to the official Zova documentation for exact command syntax. For project creation, use `zova :create:project [projectName] --template=[templateName]`.
gotcha This `zova-cli-set-front` package is an internal component. Attempting to install it directly via `npm install zova-cli-set-front` or import from it programmatically is not the intended usage and will not expose the project creation functionality.
Fix: Install the main Zova CLI globally using `pnpm add -g zova-cli@latest` and use the `zova` command for all operations, including project creation.

Install

npm install zova-cli-set-front npm
yarn add zova-cli-set-front yarn
pnpm add zova-cli-set-front pnpm

Imports

zova
wrong:
```
import { createProject } from 'zova-cli-set-front'
```
correct:
```
pnpm add -g zova-cli@latest
zova :create:project my-app --template=vuetify
```
This package is a CLI utility and is not designed for programmatic JavaScript/TypeScript imports. Its functionality is exposed via the globally installed `zova` command-line tool. The `zova :create:project` command is the primary entry point for using its templating features.
:create:project
wrong:
```
zova create project my-frontend-app
```
correct:
```
zova :create:project my-frontend-app --template=element-plus
```
The Zova CLI uses colons in its command structure (e.g., `:create:project`) to denote specific actions, which might be unfamiliar to users accustomed to traditional hyphenated or space-separated CLI commands. Ensure the exact command syntax from the documentation is used.
--template
wrong:
```
zova :create:project my-app --ui=quasar
```
correct:
```
zova :create:project my-app --template=quasar
```
When creating a new project, the specific UI framework is selected using the `--template` flag, not `--ui`. Available templates include `antdv`, `element-plus`, `quasar`, `vuetify`, and `empty`.

Quickstart

Demonstrates how to globally install the Zova CLI and scaffold a new Zova frontend project with a specific UI framework template, then run it locally.

pnpm add -g zova-cli@latest

# Create a new Zova frontend project using the Vuetify template
zova :create:project my-zova-app --template=vuetify

cd my-zova-app

# Install project dependencies (using pnpm, as recommended by Zova)
pnpm install

# Start the development server
pnpm run dev

# This will typically open the application in your browser at http://localhost:3000 (or similar)

view raw JSON →