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:
-
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.
-
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:
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
License
MIT
