Kobana UI
GitHub

Introdução

Design System para produtos Kobana

Design System composto por componentes reutilizáveis e acessíveis, construído sobre shadcn/ui.

Princípios

  • Copy, don't install — Componentes são copiados para o projeto, não importados como dependência
  • 3 camadas — Primitivos (shadcn/ui) → Compostos (Kobana) → Templates (páginas completas)
  • TypeScript-first — Tipagem completa para todos os componentes e hooks
  • CLI-driven — Instale e atualize via CLI

Quick Start

npx @kobana/ui init
npx @kobana/ui add status-badge
import { StatusBadge } from "@/components/kobana/status-badge"

export function Example() {
  return <StatusBadge status="active" label="Ativo" />
}

Componentes Disponíveis

Compostos

ComponenteDescrição
StatusBadgeBadge semântico com cores e ícones por status
ConfirmDialogDialog de confirmação com variantes
PageHeaderCabeçalho de página com breadcrumbs e ações
FilterBarBarra de filtros com múltiplos tipos
FormSectionSeção de formulário com grid responsivo
DataTableTabela de dados completa com TanStack Table
CopyCellCélula com copy-to-clipboard e truncamento
CurrencyInputInput com formatação de moeda
NumberInputInput numérico com formatação
EntityComboboxCombobox genérico com busca async
AddressFormFieldsCampos de endereço brasileiro
EmptyStateEstado vazio com ação
AppLayoutLayout de aplicação responsivo
ThemeToggleToggle de tema light/dark
LocaleToggleSeletor de idioma
RequirePermissionGate de permissão
ExportModalModal de exportação com progresso
HeaderNotificationsDropdown de notificações

Templates

TemplateDescrição
ListPagePágina de listagem completa
DetailPagePágina de detalhe com tabs
FormPagePágina de formulário com guard

Hooks

HookDescrição
useDataTableEstado do DataTable
useFiltersFiltros com URL sync
usePaginationPaginação server-side
useDebounceDebounce genérico

On this page