{"id":17080,"library":"zova-cli","title":"Zova CLI","description":"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.","status":"active","version":"1.2.36","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","framework","zova"],"install":[{"cmd":"npm install zova-cli","lang":"bash","label":"npm"},{"cmd":"yarn add zova-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add zova-cli","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Required for package management as recommended by the Zova framework documentation.","package":"pnpm","optional":false},{"reason":"Runtime environment for the CLI and Zova projects. Version >=24.8.0 is specified as a prerequisite.","package":"Node.js","optional":false}],"imports":[{"note":"The Zova documentation explicitly recommends `pnpm` for global installation and project management. Other package managers may lead to unexpected behavior or dependency conflicts.","wrong":"npm install -g zova-cli\nyarn global add zova-cli","symbol":"zova","correct":"pnpm add -g zova-cli@latest\nzova :create:project my-app --template=vuetify"},{"note":"The command syntax uses colons for sub-commands, e.g., `:create:project`, which is a specific convention of this CLI.","wrong":"zova create project my-project-name","symbol":":create:project","correct":"zova :create:project my-project-name --template=quasar"},{"note":"While not a code import, the Zova documentation recommends installing the official VSCode extension for enhanced development experience, providing code skeletons and other utilities.","wrong":null,"symbol":"zova-cli VSCode Extension","correct":"Install 'Zova - Official' extension from VSCode Marketplace"}],"quickstart":{"code":"pnpm add -g zova-cli@latest\n\n# Create a new Zova project using the Vuetify template\nzova :create:project my-zova-app --template=vuetify\n\n# Navigate into the new project directory\ncd my-zova-app\n\n# Install project dependencies (using pnpm)\npnpm install\n\n# Start the development server\npnpm run dev\n\nconsole.log('Zova development server typically runs on http://localhost:3000');","lang":"typescript","description":"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."},"warnings":[{"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.","message":"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.","severity":"gotcha","affected_versions":">=1.0.0"},{"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.","message":"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.","severity":"gotcha","affected_versions":">=1.0.0"},{"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.","message":"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.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-22T00:00:00.000Z","next_check":"2026-07-21T00:00:00.000Z","problems":[{"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.","cause":"The `zova-cli` package was not installed globally or its installation directory is not in your system's PATH.","error":"zova: command not found"},{"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.","cause":"Incompatible `pnpm` or Node.js version, or corrupted `pnpm` cache, preventing correct dependency resolution for project templates.","error":"Error: Cannot find module 'vue' or 'webpack' (or similar dependency error) during project creation or `pnpm install`."},{"fix":"Double-check the command syntax. It must be `zova :create:project projectName --template=templateName`. The colons are crucial.","cause":"Typo in the command or incorrect understanding of the colon-delimited sub-command syntax unique to `zova-cli`.","error":"Error: unknown command ':create:project'"}],"ecosystem":"npm","meta_description":null}