Summary

Cabloy is a Node.js fullstack framework designed to unify backend and frontend development, targeting developers seeking a cohesive environment for AI-assisted coding. It streamlines common development tasks through CLI-first workflows and a suite-based modular system, enabling faster and more accurate code generation and refactoring.

How It Works

Cabloy's fullstack model integrates frontend build outputs directly into backend Server-Side Rendering (SSR) via its Vona (backend) and Zova (frontend) components. This ensures a coordinated delivery path for rendering and hydration. Type information flows bidirectionally: Vona emits OpenAPI contracts for Zova to generate SDKs, while Zova produces structural metadata that enhances backend tooling. This approach promotes code sharing, workflow reuse, and cross-stack consistency.

Quick Start & Requirements

• Prerequisites: pnpm >= 11.5.2, Node.js >= 24.4.0, Redis >= 7.2.6, MySQL >= 8, PostgreSQL >= 16. SQLite3 is built-in.
• Installation: Create a basic project with npm create cabloy. For the "Cabloy Start" edition (requires purchase), clone git@github.com:cabloy/cabloy-start.git and run npm run init.
• Documentation: Official documentation is available at docs.cabloy.com.

Highlighted Details

• Unified fullstack architecture integrating backend and frontend development.
• Vona (backend) and Zova (frontend) frameworks enable code sharing and consistency.
• Suite-based modular system for organizing capabilities into composable units.
• Supports multiple delivery modes: SSR, SPA, Web, and Admin applications.
• CLI-first workflows automate scaffolding, metadata generation, refactoring, and verification for "AI vibe coding."
• Monorepo-native development practices.
• Technology Stack includes TypeScript, Koa, Knex, Vue, Vite, Quasar, and TanStack libraries.
• UI Layers: Cabloy Basic uses DaisyUI + Tailwind CSS; Cabloy Start uses Vuetify.

Maintenance & Community

Contributions are managed via the root package.json scripts. Bug reporting and feature proposals should be submitted through GitHub Issues or Pull Requests. Community engagement channels include GitHub Issues, X/Twitter, and Bilibili.

Licensing & Compatibility

The project is licensed under the MIT license, generally permitting commercial use and integration without significant copyleft restrictions.

Limitations & Caveats

The "Cabloy Start" edition requires a purchase. The framework's emphasis on "AI vibe coding" and integration with specific tools like "Claude Code" may necessitate specialized setup or workflows. The distinction between "Cabloy Basic" and "Cabloy Start" may imply differences in features or support levels.