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.

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 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. | ✅ | — |

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 shared user-facing and agent-facing guidance in cabloy.com; keep independently delivered suite guidance in its owning suite README and docs/
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

cabloy/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.