Início rápido
Crie seu primeiro projeto kubojs em minutos
Filosofia
- Monte sua própria stack: escolha só o que precisa, nada a mais.
- Templates mínimos: scaffolds enxutos, sem inchaço.
- Dependências atualizadas: sempre atuais e estáveis por padrão.
- Gratuito e open source: para sempre.
Comece agora
Pré-requisitos
- Node.js LTS - Baixe em nodejs.org
- Git (opcional) - Baixe em git-scm.com - se quiser inicializar um repositório git
- Bun (opcional) - Baixe em bun.com - se quiser usar o Bun como gerenciador de pacotes
CLI (prompts)
npm create kubojs@latestSiga os prompts interativos para escolher frontend, backend, banco de dados, ORM, camada de API e addons.
Pule os prompts e use a stack padrão:
npm create kubojs@latest --yesStack Builder (UI)
- Acesse /new para montar sua stack e copiar o comando gerado
- Ou abra via:
npm create kubojs@latest builderAgente de IA (plugin)
Deixe seu assistente de IA montar a stack por você. Instale o plugin kubojs e descreva o que quer em português (ou inglês) — ele planeja uma stack válida e gera o scaffold.
# Claude Code
/plugin marketplace add albuquerquesz/kubo
/plugin install kubojs@kubojsDepois peça: "create a fullstack app with Next, Hono, Postgres and Better Auth". Também funciona no Codex, opencode e em qualquer agente com MCP — veja Usar dentro do seu agente de IA.
Configurações comuns
Stack padrão
npm create kubojs@latest my-webapp \
--frontend tanstack-router \
--backend hono \
--database sqlite \
--orm drizzle \
--auth better-auth \
--addons turborepoConvex + React + Clerk
npm create kubojs@latest my-api \
--frontend tanstack-router \
--backend convex \
--auth clerkApp mobile (Expo)
npm create kubojs@latest my-native \
--frontend native-uniwind \
--backend hono \
--database sqlite \
--orm drizzle \
--auth better-authMonorepo vazio
npm create kubojs@latest my-workspace \
--frontend none \
--backend noneCola de flags
Veja a lista completa na Referência da CLI. Flags principais:
--frontend: tanstack-router, react-router, tanstack-start, next, nuxt, svelte, solid, astro, native-bare, native-uniwind, native-unistyles, none--backend: hono, express, fastify, elysia, convex, self, none--runtime: bun, node, workers, none--database: sqlite, postgres, mysql, mongodb, none--orm: drizzle, prisma, mongoose, none--api: trpc, orpc, none--auth: better-auth, clerk, none--payments: none--addons: turborepo, nx, vite-plus, pwa, tauri, electrobun, biome, lefthook, husky, starlight, fumadocs, ultracite, oxlint, mcp, opentui, wxt, skills, evlog, none--examples: todo, ai, none
Próximos passos
CLI (por comando)
Flags, uso e exemplos de cada comando
Plugin de agente de IA
Scaffold a partir do Claude Code, Codex, opencode e outros agentes MCP
Estrutura do projeto
Veja como layouts web/server/native e Convex são gerados
Compatibilidade
Combinações válidas de backend, runtime, banco, ORM e API
bts.jsonc
Necessário para o comando add; pode apagar se não for usar o add
Contribuindo
Setup de desenvolvimento e fluxo de contribuição