{"id":17480,"library":"zova-cli-set-front","title":"Zova CLI Frontend Project Template Provisioner","description":"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.","status":"active","version":"1.2.34","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","framework","zova"],"install":[{"cmd":"npm install zova-cli-set-front","lang":"bash","label":"npm"},{"cmd":"yarn add zova-cli-set-front","lang":"bash","label":"yarn"},{"cmd":"pnpm add zova-cli-set-front","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"This package is an internal component that extends the functionality of the main Zova CLI tool, providing specific project scaffolding capabilities. Users interact with `zova-cli` directly.","package":"zova-cli","optional":false},{"reason":"Zova CLI documentation specifies `pnpm` (>=10.19.0) as the recommended package manager for installing the CLI and managing Zova projects.","package":"pnpm","optional":false},{"reason":"Zova CLI requires Node.js (>=24.8.0) as its runtime environment.","package":"Node.js","optional":false}],"imports":[{"note":"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.","wrong":"import { createProject } from 'zova-cli-set-front'","symbol":"zova","correct":"pnpm add -g zova-cli@latest\nzova :create:project my-app --template=vuetify"},{"note":"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.","wrong":"zova create project my-frontend-app","symbol":":create:project","correct":"zova :create:project my-frontend-app --template=element-plus"},{"note":"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`.","wrong":"zova :create:project my-app --ui=quasar","symbol":"--template","correct":"zova :create:project my-app --template=quasar"}],"quickstart":{"code":"pnpm add -g zova-cli@latest\n\n# Create a new Zova frontend project using the Vuetify template\nzova :create:project my-zova-app --template=vuetify\n\ncd my-zova-app\n\n# Install project dependencies (using pnpm, as recommended by Zova)\npnpm install\n\n# Start the development server\npnpm run dev\n\n# This will typically open the application in your browser at http://localhost:3000 (or similar)","lang":"typescript","description":"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."},"warnings":[{"fix":"Ensure Node.js is >=24.8.0 and pnpm is >=10.19.0. Update your Node.js and pnpm installations if necessary.","message":"Zova CLI has strict Node.js and pnpm version requirements. Using unsupported versions may lead to installation failures or unexpected behavior.","severity":"breaking","affected_versions":"<=1.2.34"},{"fix":"Always refer to the official Zova documentation for exact command syntax. For project creation, use `zova :create:project [projectName] --template=[templateName]`.","message":"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.","severity":"gotcha","affected_versions":">=1.0.0"},{"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.","message":"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.","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`: `pnpm add -g zova-cli@latest`. Verify `pnpm`'s global bin directory is in your system's PATH.","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.","error":"zova :create:project: command not found"},{"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`.","cause":"Your current Node.js version is older than the minimum requirement specified by Zova CLI.","error":"Error: Node.js version unsupported. Zova CLI requires Node.js >=24.8.0"}],"ecosystem":"npm","meta_description":null}