Kubo

A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations.

Quick Start

# Using bun (recommended)
bun create kubojs@latest

# Using pnpm
pnpm create kubojs@latest

# Using npm
npx create-kubojs@latest

Features

• Frontend: React (TanStack Router, React Router, TanStack Start), Next.js, Nuxt, Svelte, Solid, Astro, React Native (Bare, NativeWind, Unistyles), or none
• Backend: Hono, Express, Fastify, Elysia, Self (fullstack web app), Convex, or none
• API: tRPC or oRPC (or none)
• Runtime: Bun, Node.js, or Cloudflare Workers
• Databases: SQLite, PostgreSQL, MySQL, MongoDB (or none)
• ORMs: Drizzle, Prisma, Mongoose (or none)
• Auth: Better Auth or Clerk (optional)
• Addons: Turborepo, Nx, PWA, Tauri, Electrobun, Biome, Lefthook, Husky, Starlight, Fumadocs, Ultracite, Oxlint, MCP, OpenTUI, WXT, Skills, Get Monitor, Guara Cloud, AbacatePay
• Examples: Todo, AI
• DB Setup: Turso, Neon, Supabase, Prisma PostgreSQL, MongoDB Atlas, Cloudflare D1, Docker
• Web Deploy: Cloudflare Workers

Type safety end-to-end, clean monorepo layout, and zero lock-in: you choose only what you need.

Repository Structure

This repository is organized as a monorepo containing:

• CLI: apps/cli — published as create-kubojs (bins: create-kubojs, kubojs; @kubojs/cli compat alias)
• Documentation / site: apps/web — Next.js marketing + docs
• Video: apps/video — Remotion app (@kubojs/video) for brand/launch videos; Studio + render only (not nested under the web site)
• Packages: packages/types, packages/template-generator, packages/backend

Agent-oriented layout notes: .agents/skills/kubojs/reference/monorepo-map.md.

Documentation

Run the local docs site with bun dev (port 3333). Source lives in apps/web/content/docs. Use the Stack Builder at /new when the site is running.

Development

# Clone the repository
git clone https://github.com/albuquerquesz/kubo.git
cd kubo

# Install dependencies
bun install

# Start website development
bun dev

# Start CLI development
bun cli

# Remotion Studio (launch / brand videos)
bun run dev:video

Want to contribute?

Please read the Contribution Guide first and open an issue before starting new features to ensure alignment with project goals.

• Docs: ./apps/web/content/docs/contributing.mdx
• Repo guide: ./.github/CONTRIBUTING.md