Cabloy

Cabloy is a Node.js fullstack framework for AI vibe coding, with AI Spec-Driven Development guiding work from confirmed specs to verifiable delivery.

Cabloy Basic and Cabloy Start are complete editions built on this shared architecture; see Editions Overview for their differences.

Documentation · npm · Demo · GitHub

Fullstack Principles

Cabloy connects Vona and Zova in two ways:

1. Integrated SSR. Zova builds the frontend and SSR artifacts. In Vona integrated SSR, Vona consumes those artifacts to render the page, and Zova hydrates it in the browser.

2. Bidirectional contract flow. Vona's OpenAPI contracts generate Zova SDKs and schema-aware helpers. Zova's generated metadata and types for routes, components, and icons feed back into Vona's tooling and type hints.

Learn more about Vona + Zova Integration and the Contract Loop.

Get Started

Create a new Cabloy Basic project:

npm create cabloy@latest

For Cabloy Start, clone the Cabloy Start repository and run npm run init from its root. See the Fullstack Quickstart for prerequisites and development commands.

AI Spec-Driven Development

See the AI Spec-Driven Development.

Demonstrations(Videos)

1. AI Coding in Action: One Prompt for CRUD, SSR & Multitasking (Duration: 3:50)

Editions

Cabloy is available through two complete project baselines, each maintained in its own repository:

• Cabloy Basic — the public framework and reference edition, licensed under MIT, with a DaisyUI + Tailwind CSS UI layer and an e-commerce-oriented demonstration suite.
• Cabloy Start — a public starter edition, licensed under MIT, with a Vuetify UI layer and built-in system-management and authorization demonstrations.

Both editions share Cabloy’s Vona + Zova architecture, CLI-first workflows, bidirectional type synchronization, and AI Spec-Driven Development model. They differ primarily in their default UI layer, included demonstration suites, and out-of-the-box application baseline.

For fuller guidance on choosing an edition and working in an existing checkout, see Cabloy Editions.

Legend: ✅ Included in the default edition baseline · — Not included in the default edition baseline

Default UI Layer

Area	Cabloy Basic	Cabloy Start
UI library	DaisyUI + Tailwind CSS	Vuetify

Included Core Capabilities

Capability	Description	Cabloy Basic	Cabloy Start
Master–detail forms	Supports nested master–detail forms, including multiple levels of detail records.	✅	✅
Image uploads	Supports local storage and Cloudflare storage backends.	✅	✅
File uploads	Supports local storage and Cloudflare storage backends.	✅	✅
Payment integrations	Demonstrates simulated payments, PayPal, and Stripe integrations.	✅	✅
Markdown editor	Includes image uploads and syntax highlighting.	✅	✅

Included Demonstration Suites

Suite	What it demonstrates	Cabloy Basic	Cabloy Start
Student Training Management	Master–detail forms, nested detail records, image uploads, and file uploads. Cabloy Start additionally demonstrates data-scope-based RBAC.	✅	✅
E-commerce	A complete Admin site, Web site, personal center, payment flows, Markdown editing, and related capabilities.	✅	—
System Management	User management, role management, department management, RBAC authorization, and menu authorization.	—	✅

Included demonstration suites give AI vibe coding agents high-quality, project-native code examples. They improve development efficiency while reducing token use. For production deployments, set PROJECT_DISABLED_SUITES to a comma-separated list of unneeded suite names to disable them; see the Environment and Config Guide.

“Not included” means that the suite is not part of the default edition baseline. It does not limit what can be built with Cabloy.

Technology Stack

General

Package	Version
TypeScript	^5.9.3
Zod	^4.3.6

Backend (Vona)

Package	Version
Koa	^3.2.0
Knex	^3.2.9
Redis Client (ioredis)	^5.10.1
SQLite Driver (better-sqlite3)	^12.9.0

Frontend (Zova)

Package	Version
Vue	^3.5.32
Vite	^8.0.14
Quasar	^2.19.3
TanStack Query	^5.100.10
TanStack Form	^1.32.0
TanStack Table	^8.21.3

Shared Frontend Engineering Layer

• Vue
• Vite
• Quasar tooling such as quasar dev and quasar build
• TanStack libraries where applicable

Quasar is used here for engineering tooling rather than as the edition UI component library.

Edition-specific UI Layer

• Cabloy Basic: DaisyUI + Tailwind CSS
• Cabloy Start: Vuetify

Contributing

Contributions to the Cabloy framework, docs, and tooling are welcome.

Use the root package.json as the shared workflow entrypoint:

npm run init
npm run db:reset
npm run dev
npm run tsc
npm run test
npm run build

For more details, see:

• Cabloy Editions
• Repo Scripts
• Package Map
• AI Development Introduction

Contribution guidelines:

• prefer CLI-backed workflows with npm run vona and npm run zova
• put user-facing and agent-facing guidance in cabloy.com
• put maintainer rationale, architecture notes, and engineering ADRs in repo-docs-internal/
• put product and business specifications, delivery plans, and suite-local ADRs in repo-specs/
• verify framework changes with the narrowest meaningful checks first, then shared root scripts when broader confidence is needed

To report bugs or propose changes, use GitHub Issues or open a pull request in github.com/cabloy/cabloy.

Community

• GitHub Issues
• X / Twitter
• Bilibili

License

MIT