https://github.com/cabloy/cabloy
🚀 Cabloy is a Node.js fullstack framework for AI vibe coding.
https://github.com/cabloy/cabloy
full-stack nodejs
Last synced: 5 days ago
JSON representation
🚀 Cabloy is a Node.js fullstack framework for AI vibe coding.
- Host: GitHub
- URL: https://github.com/cabloy/cabloy
- Owner: cabloy
- License: mit
- Created: 2018-01-14T05:13:19.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2026-06-10T08:45:29.000Z (8 days ago)
- Last Synced: 2026-06-10T09:14:21.041Z (8 days ago)
- Topics: full-stack, nodejs
- Language: TypeScript
- Homepage: https://cabloy.com
- Size: 248 MB
- Stars: 966
- Watchers: 22
- Forks: 132
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nodejs - CabloyJS - A Node.js full-stack framework with workflow engine, based on koa + egg + vue + framework7.  (Repository / Web Frameworks)
README
# Cabloy
[](https://github.com/cabloy/cabloy/blob/main/LICENSE)
[](https://www.npmjs.com/package/cabloy)
[](https://www.npmjs.com/package/cabloy)
[](https://docs.cabloy.com)
[](https://cabloy.com)
Cabloy is a Node.js fullstack framework for AI vibe coding.
Use one fullstack framework instead of stitching together separate backend and frontend stacks.
With Vona, Zova, suite-based modules, and CLI-first workflows, Cabloy turns common scaffolding, metadata, refactors, and verification into explicit commands for faster, more accurate AI vibe coding.
[Documentation](https://docs.cabloy.com) · [npm](https://www.npmjs.com/package/cabloy) · [Web Demo](https://cabloy.com) · [Admin Demo](https://cabloy.com/admin) · [GitHub](https://github.com/cabloy/cabloy)
## Get Started
### Prerequisites
Before creating a new Cabloy project, make sure your environment has:
| Name | Version |
| ---------- | ---------- |
| pnpm | `>=11.5.2` |
| Node.js | `>=24.4.0` |
| Redis | `>=7.2.6` |
| SQLite3 | `Built-in` |
| MySQL | `>=8` |
| PostgreSQL | `>=16` |
- `Redis`: powers queue, schedule, startup, broadcast, caching, two-layer cache, and redlock
- `SQLite3`: if you use `better-sqlite3`, set up `node-gyp` before installing dependencies
Create a new Cabloy project:
```bash
npm create cabloy
```
The generated project already includes `CLAUDE.md` and the `.claude/` workspace assets. This path creates a Cabloy Basic project baseline. Open this project in Claude Code and start coding immediately with project-specific guidance.
For **Cabloy Start**, purchase access to the licensed private repository, clone `git@github.com:cabloy/cabloy-start.git`, and run `npm run init`. For the complete Start onboarding flow, read the [Cabloy Start](https://docs.cabloy.com/editions/cabloy-start) page.
Then continue with the framework docs:
- [Fullstack Quickstart](https://docs.cabloy.com/fullstack/quickstart)
- [Documentation](https://docs.cabloy.com)
- [Fullstack Introduction](https://docs.cabloy.com/fullstack/introduction)
- [Backend Introduction](https://docs.cabloy.com/backend/introduction)
- [Frontend Introduction](https://docs.cabloy.com/frontend/introduction)
- [Editions Overview](https://docs.cabloy.com/editions/overview)
- [Choosing Between Cabloy Basic and Cabloy Start](https://docs.cabloy.com/editions/choosing-between-basic-and-start)
To upgrade an existing Cabloy project:
```bash
npm run upgrade
```
## Highlights
- **One framework system** — build backend and frontend in one fullstack architecture
- **Vona + Zova** — use aligned backend and frontend frameworks for code sharing, workflow reuse, and cross-stack consistency
- **Suite-based modular system** — organize capabilities as suites and modules so services, features, metadata, and tooling evolve in composable units
- **Multiple delivery modes** — deliver SSR, SPA, Web, and Admin applications with shared conventions across the stack
- **CLI-first workflows for AI vibe coding** — turn common scaffolding, metadata, refactors, and verification into explicit commands for faster, more accurate AI vibe coding
- **Monorepo-native development** — keep framework source, docs, and tooling aligned in one monorepo workflow
## 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](https://github.com/cabloy/cabloy/blob/main/package.json) as the shared workflow entrypoint:
```bash
npm run init
npm run dev
npm run tsc
npm run test
npm run build
```
For more details, see:
- [Editions Overview](https://docs.cabloy.com/editions/overview)
- [Choosing Between Cabloy Basic and Cabloy Start](https://docs.cabloy.com/editions/choosing-between-basic-and-start)
- [Repo Scripts](https://docs.cabloy.com/reference/repo-scripts)
- [Package Map](https://docs.cabloy.com/reference/package-map)
- [AI Development Introduction](https://docs.cabloy.com/ai/introduction)
Contribution guidelines:
- prefer CLI-backed workflows with `npm run vona` and `npm run zova`
- put user-facing and agent-facing guidance in [docs.cabloy.com](https://docs.cabloy.com)
- put maintainer rationale, architecture notes, and ADRs in [.docs-internal/](https://github.com/cabloy/cabloy/tree/main/.docs-internal)
- 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](https://github.com/cabloy/cabloy/issues) or open a pull request in [github.com/cabloy/cabloy](https://github.com/cabloy/cabloy).
## Community
- [GitHub Issues](https://github.com/cabloy/cabloy/issues)
- [X / Twitter](https://x.com/zhennann2024)
- [Bilibili](https://space.bilibili.com/454737998)
## License
[MIT](https://github.com/cabloy/cabloy/blob/main/LICENSE)