Zova CLI

1.2.36 · active · verified Wed Apr 22

Zova CLI is the official command-line interface tool for the Zova framework, a comprehensive full-stack solution designed to offer an intuitive development experience by integrating the strengths of Vue3, React, and Angular. The CLI, currently at version 1.2.36, is actively maintained and updated in alignment with the Zova framework's ongoing development. Zova differentiates itself by streamlining reactivity (eliminating the need for `ref.value` in Vue3 contexts), adopting a flexible TSX-based rendering approach similar to React but with a simplified 'Render Class' model to reduce complexity, and leveraging a powerful, yet simplified, Inversion of Control (IOC) container inspired by Angular to unify state management. The CLI facilitates project creation, offering various templates like Quasar, Vuetify, and an empty base for other UI libraries, enabling developers to quickly set up Zova applications with SSR, modularization, and CSS-in-JS capabilities.

Common errors

```
zova: command not found
```
cause The `zova-cli` package was not installed globally or its installation directory is not in your system's PATH.

fix Ensure `zova-cli` is installed globally using `pnpm add -g zova-cli@latest`. Verify `pnpm`'s global bin directory is in your system's PATH.
```
Error: Cannot find module 'vue' or 'webpack' (or similar dependency error) during project creation or `pnpm install`.
```
cause Incompatible `pnpm` or Node.js version, or corrupted `pnpm` cache, preventing correct dependency resolution for project templates.

fix Verify Node.js version (>=24.8.0) and `pnpm` version. Try clearing `pnpm` cache (`pnpm store prune`) or reinstalling global `zova-cli` and project dependencies from scratch.
```
Error: unknown command ':create:project'
```
cause Typo in the command or incorrect understanding of the colon-delimited sub-command syntax unique to `zova-cli`.

fix Double-check the command syntax. It must be `zova :create:project projectName --template=templateName`. The colons are crucial.

Warnings

gotcha The Zova framework documentation explicitly recommends `pnpm` as the package manager. Using `npm` or `yarn` for global installation or project dependency management might lead to unexpected dependency resolution issues or other inconsistencies with the framework's design.
Fix: Always use `pnpm` for installing `zova-cli` globally and for managing Zova project dependencies. Ensure `pnpm` is installed (`npm install -g pnpm`) and updated.
gotcha Zova CLI commands utilize a specific colon-delimited syntax for sub-commands (e.g., `:create:project`). Misunderstanding this syntax can lead to command not found errors.
Fix: Always refer to the Zova documentation for the precise command syntax, especially for sub-commands and options. Use `zova --help` for general command overview.
gotcha The Zova framework has specific Node.js version requirements (e.g., >=24.8.0). Using an older or incompatible Node.js version can cause installation failures or runtime errors for both the CLI and generated projects.
Fix: Ensure your Node.js version meets the prerequisites specified in the Zova documentation. Use a Node Version Manager (like `nvm` or `fnm`) to easily switch and manage Node.js versions.

Install

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

Imports

zova
wrong:
```
npm install -g zova-cli
yarn global add zova-cli
```
correct:
```
pnpm add -g zova-cli@latest
zova :create:project my-app --template=vuetify
```
The Zova documentation explicitly recommends `pnpm` for global installation and project management. Other package managers may lead to unexpected behavior or dependency conflicts.
:create:project
wrong:
```
zova create project my-project-name
```
correct:
```
zova :create:project my-project-name --template=quasar
```
The command syntax uses colons for sub-commands, e.g., `:create:project`, which is a specific convention of this CLI.
zova-cli VSCode Extension
```
Install 'Zova - Official' extension from VSCode Marketplace
```
While not a code import, the Zova documentation recommends installing the official VSCode extension for enhanced development experience, providing code skeletons and other utilities.

Quickstart

Demonstrates the global installation of zova-cli, creation of a new Zova project with a specified template (Vuetify), installation of project dependencies, and starting the development server.

pnpm add -g zova-cli@latest

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

# Navigate into the new project directory
cd my-zova-app

# Install project dependencies (using pnpm)
pnpm install

# Start the development server
pnpm run dev

console.log('Zova development server typically runs on http://localhost:3000');

view raw JSON →