tucu-ui-pro
Usar siempre que un frontend React/Next use (o vaya a usar) @e-burgos/tucu-ui — montarlo en Vite, Next 16 o una app con Tailwind propio, elegir ThemeProvider/layout/preset, tematizar con customPaletteColor y tokens --tucu-*, elegir el componente correcto con sus props válidos y esquivar las trampas que rompen en runtime, con o sin el MCP tucu-ui conectado.
- License 许可
- MIT
- 最近更新
- 2026-11-13
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- tucu-ui-pro
- description
- Usar siempre que un frontend React/Next use (o vaya a usar) @e-burgos/tucu-ui — montarlo en Vite, Next 16 o una app con Tailwind propio, elegir ThemeProvider/layout/preset, tematizar con customPaletteColor y tokens --tucu-*, elegir el componente correcto con sus props válidos y esquivar las trampas que rompen en runtime, con o sin el MCP tucu-ui conectado.
02 资源文件 4
- 参考文档references/01-montaje.md4.4 KB
- 参考文档references/02-theming.md5.0 KB
- 参考文档references/03-componentes.md6.0 KB
- 参考文档references/04-trampas.md3.4 KB
03 SKILL.md 正文
Skill: tucu-ui-pro
tucu-ui (@e-burgos/tucu-ui) es una librería React + Tailwind v4 que trae el shell completo
(ThemeProvider = router + layout + tema), ~110 componentes, gráficos, DataTable sobre TanStack,
formularios Zod + react-hook-form, iconos y temas macOS. Esta skill es el oficio de usarla bien. El
criterio visual (qué lenguaje, qué jerarquía) vive en la skill design-languages; el motion en
crafted-motion. Si el subproyecto declara reglas propias en su constitution.md, esas mandan.
Base verificada: tucu-ui 3.10.0 y tucu-ui-mcp 0.16.0. Antes de escribir código leé la versión del
package.jsondel subproyecto: si es anterior, verificá cada prop con el MCP (get_props) o con los tipos ennode_modules/@e-burgos/tucu-ui— entre 3.0 y 3.10 hubo renombres (ej. elButton variant="brand"de 3.0 no existe en 3.10: esvariant="solid").
Flujo de trabajo (siempre en este orden)
- Montaje: confirmar cómo está instalado (o instalarlo) →
references/01-montaje.md. Un montaje mal hecho (doble Tailwind,@sourcemal apuntado, providers de Vite en Next) produce estilos que faltan sin ningún error. - Lenguaje visual: si la task es de diseño, elegir o leer el lenguaje en
design-languages. - Tema: ThemeProvider (
themeStyle,layout,preset,customPaletteColor) y overrides de tokens →references/02-theming.md. - Componentes: elegir del catálogo antes de escribir uno propio →
references/03-componentes.md. Con el MCP conectado,get_component/get_propspor cada componente que uses por primera vez en la task; los generadores (generate_page,generate_form,generate_datatable) dan un punto de partida, no el resultado final. - Trampas: repasar
references/04-trampas.mdantes de dar la task por terminada. - Verificar en el navegador: desktop y 375 px, light y dark,
prefers-reduced-motion, foco visible y navegación por teclado. Sin consola con errores ni warnings de React.
Con MCP y sin MCP
| Situación | Fuente de verdad |
|---|---|
MCP tucu-ui conectado (pnpm sdd:tucu -- --status) |
get_component, get_props, search_components, search_icons; recursos tucu://tokens, tucu://theme, tucu://layouts, tucu://styling-overrides, tucu://design-guide; prompt design-review al cerrar |
| Sin MCP | esta skill + los tipos .d.ts de node_modules/@e-burgos/tucu-ui (grep del nombre del prop) |
Skill tucu-ui-design instalada (integración prendida) |
su design-guide.md y checklist.md como segunda opinión de composición |
Nunca inventes un prop: si no aparece en el MCP ni en los tipos, no existe.
Reglas de oficio
- Componente de tucu-ui antes que uno propio. Antes de escribir una card, badge, tabs, tabla,
filtro, KPI o modal, buscalo (
search_componentso03-componentes.md). Lo propio solo si no existe, y entonces se compone con primitivos de tucu-ui y tokens, no con colores sueltos. - Tokens, no hex. Color de acción = marca (
bg-brand,text-brand,Buttonsólido). Textotext-foreground/text-muted, bordesborder-border, superficiesbg-body/bg-light-dark. Clases que parecen de shadcn (text-muted-foreground,bg-card,bg-popover,text-destructive) no existen en tucu-ui y no pintan nada. - La marca se define una vez en
customPaletteColor(obrandColor/preset), nunca repartida en clasessky-500por los componentes. - El mismo dato lleva el mismo tono en todas las pantallas (estado pagado =
greensiempre). - Números en mono tabular (
font-mono tabular-nums,MoneyTextpara dinero). cn()de tucu-ui para unir clases: usa tailwind-merge, así tuclassNamegana sobre el default del componente.- Light y dark son de primera clase: nunca fijes
text-whiteotext-zinc-*en el contenedor raíz de una página (se hereda y deja invisibles los títulos en el modo opuesto).
Cuándo leer cada reference
| Necesidad | Archivo |
|---|---|
Instalar, CSS de entrada, @source, Vite vs Next, MFE |
references/01-montaje.md |
| ThemeProvider, themeStyle/layout, presets, ThemeScope, paleta, tokens y overrides | references/02-theming.md |
| Qué componente usar y sus props clave, por categoría | references/03-componentes.md |
| Props que rompen en runtime, comportamientos sorpresivos, checklist | references/04-trampas.md |
04 同仓库更多 Skills
nx-migration
Usar al migrar un workspace Nx a una mayor nueva (22 a 23, 23 a 24), actualizar la versión de Nx de un monorepo, resolver errores después de `nx migrate`, o decidir si subir TypeScript 7 — método de un salto de mayor a la vez, registro como fix en el SDD, checklist de verificación por salto, trampas conocidas por versión y el comando `pnpm sdd:nx-migrate`.
design-languages
Usar al diseñar o rediseñar la UI de un frontend (app, dashboard, landing, auth, storefront) o cuando el pedido nombra un look ("como Display Ads", "liquid glass", "cristal líquido", "oscuro tipo consola", "estilo Apple") — elegir o derivar un lenguaje visual completo (tokens, tipografía, superficies, escena, componentes firma, motion, accesibilidad), aplicarlo con tucu-ui y verificarlo. Trae dos lenguajes probados en producción listos para replicar.
tucu-ui-pro
Usar siempre que un frontend React/Next use (o vaya a usar) @e-burgos/tucu-ui — montarlo en Vite, Next 16 o una app con Tailwind propio, elegir ThemeProvider/layout/preset, tematizar con customPaletteColor y tokens --tucu-*, elegir el componente correcto con sus props válidos y esquivar las trampas que rompen en runtime, con o sin el MCP tucu-ui conectado.
nx-migration
Usar al migrar un workspace Nx a una mayor nueva (22 a 23, 23 a 24), actualizar la versión de Nx de un monorepo, resolver errores después de `nx migrate`, o decidir si subir TypeScript 7 — método de un salto de mayor a la vez, registro como fix en el SDD, checklist de verificación por salto, trampas conocidas por versión y el comando `pnpm sdd:nx-migrate`.
design-languages
Usar al diseñar o rediseñar la UI de un frontend (app, dashboard, landing, auth, storefront) o cuando el pedido nombra un look ("como Display Ads", "liquid glass", "cristal líquido", "oscuro tipo consola", "estilo Apple") — elegir o derivar un lenguaje visual completo (tokens, tipografía, superficies, escena, componentes firma, motion, accesibilidad), aplicarlo con tucu-ui y verificarlo. Trae dos lenguajes probados en producción listos para replicar.
setup-graphify
Instala y configura graphify (grafo de conocimiento del repo) para un dev que lo quiera usar. Elige un backend gratuito, valida el modelo con una medición real y construye el primer grafo. Invocar solo si el dev pide habilitar graphify.