Vona

April 26, 2026 · View on GitHub

Vona

Vona is a fullstack framework for building SSR/SPA/Website/Admin-Dashboard in one codebase, featuring frontend and backend separation and native type sharing

Supports dual-layer tabs navigation, enabling efficient page switching while maintaining page state
Dynamically render CRUD list pages, entry pages, and search forms, while demonstrating best practices for Tanstack Table, Tanstack Form, and Tanstack Query
Dynamically infer and generate DTOs to eliminate redundant type definitions and boost development productivity

Fullstack Mechanism

Vona adopts a frontend-backend separation architecture. The frontend uses the Zova framework, and the built JS bundle is placed into the Vona backend for direct SSR rendering on the backend

Frontend-backend type sharing mechanism:

The backend generates Swagger/OpenAPI Schema for generating API SDK on the frontend
The frontend generates types for icons, routes, and components for providing type hints on the backend

Documentation

Docs

Demo Online

The Website and Admin-Dashboard of Cabloy Store are built by one codebase

Website: https://cabloy.com
Admin-Dashboard: https://cabloy.com/admin

GIF Demo

Dual-layer tabs navigation

Technology Stack

General

Name	Version
pnpm	>=10.19.0
Nodejs	>=24.8.0
Typescript	>=5.9.3

Backend(Vona)

Name	Version
Koa	>=3.0.0
Knex	>=3.1.0
Zod	>=4.1.13
Redis	>=7.2.6
Sqlite3	builtin
MySQL	>=8
Postgresql	>=16

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

Frontend(Zova)

Name	Version
Vite	>=8.0.0
Vue	>=3.5.6
Vue Router	>=4.4.5
Zod	>=4.1.13
Tanstack Query	>=5.92.5
Tanstack Form	>=1.23.5
Tanstack Table	>=8.21.3

UI Libraries

Zova can be used with any UI library and comes with built-in project templates for several UI libraries, making it easy to use out of the box

Name	Version
Daisyui	>=5.3.2
Tailwindcss	>=4.1.14
Quasar	>=2.18.1
Vuetify	>=4.0.1

Stay In Touch

License

MIT