Vona CLI

1.1.53 verified Sat Apr 25 auth: no javascript

The Vona CLI is a command-line interface for the Vona framework, version 1.1.53. It provides tooling for scaffolding, building, and managing Vona projects. The package is designed to streamline development workflows within the Vona ecosystem, with a focus on simplicity and integration. Active development is ongoing, with releases every few weeks. Key differentiator: tightly coupled with Vona framework for seamless project management.

Common errors

error Error: Cannot find module 'vona' ↓

cause Vona framework not installed when CLI attempts to use it.

fix

Run 'npm install vona' in your project directory.

Warnings

gotcha The CLI assumes the Vona framework is installed globally or locally. If not present, commands may fail. ↓

fix Ensure 'vona' is installed (npm install vona) before using CLI.

deprecated The 'generate' command is deprecated in v1.1.0 and will be removed in v2.0.0. ↓

fix Use 'scaffold' command instead.

Install

npm install vona-cli

yarn add vona-cli

pnpm add vona-cli

Imports

VonaCLI
wrong
```
const VonaCLI = require('vona-cli')
```
correct
```
import VonaCLI from 'vona-cli'
```
Default export, ESM-only; CommonJS require not supported.

Quickstart

Shows how to programmatically run the CLI and also the terminal command. Uses default import and a simple init command.

import VonaCLI from 'vona-cli';
const cli = new VonaCLI();
cli.run(['init', '--name', 'my-project']);
// Or use the CLI directly from the terminal:
// $ npx vona init --name my-project