Quick Start

Prerequisites

Name	Version
pnpm	>=10.19.0
Nodejs	>=24.8.0
Redis	>=7.2.6
Sqlite3	Built-in
MySQL	>=8
Postgresql	>=17

• Redis: VonaJS provides the following capabilities based on Redis:
  • Queue, Schedule, Startup, Broadcast, Caching, Two-layer cache, and Redlock
• Sqlite3: You need to set up the node-gyp environment in advance to ensure that better_sqlite3.node can be compiled properly when installing dependencies

Preparation

1. Install command-line tools

$ pnpm add -g vona-cli@latest

2. Install Vscode extension: Vona - Official

This extension provides a large number of menus for quickly creating code skeletons for various resources

Quick Start

1. Create Project

$ vona :create:project projectName
$ cd projectName

2. Modify .env file

env/.env:

# database
DATABASE_DEFAULT_CLIENT = 'sqlite3' # sqlite3/pg/mysql
DATABASE_CLIENT_PG_PASSWORD =
DATABASE_CLIENT_MYSQL_PASSWORD =

# redis
REDIS_DEFAULT_PASSWORD =

3. Start Dev Server

$ npm run dev

4. Unit test

$ npm run test

5. Build

$ npm run build

Docker Compose

$ npm run build:docker
$ sudo docker-compose build
$ sudo docker-compose up