Saltar a contenido

0003. UI sobre Tailwind CSS 4 y shadcn-vue (reka-ui)

Estado: Aceptado Fecha: 2026-10-23 Autor: Duval Alcivar Módulo(s) afectado(s): panel administrativo (core-admin): sistema de componentes y estilos Evidencia: commit 5c3ab19 (2026-10-23) y components.json, src/shared/components/ui, package.json

Contexto

El template Tabler arrastraba una copia completa de su stack: estilos en src/styles/template, librerías en public/template/libs (apexcharts, tinymce, dropzone, jsvectormap, litepicker, plyr, list.js, nouislider, star-rating.js, countup.js, fslightbox) y assets en public/assets (jQuery 2.1.1, jQuery UI, Highcharts, Notiflix, nestedSortable, fabric, mask). El panel usa una fracción mínima de todo eso y necesitaba componentes accesibles y controlables.

Decisión

La UI se construye sobre Tailwind CSS 4.3.3 con @tailwindcss/vite y primitivas reka-ui 2.11.0. Los componentes se copian al repositorio en src/shared/components/ui (button, input, select, dialog, table, tabs, tooltip, sonner, …) y las variantes se declaran con class-variance-authority + cn. components.json fija style: reka-vega, baseColor: neutral e iconLibrary: tabler. Se elimina la copia completa del template; Tabler sobrevive solo como @tabler/icons-vue, con size y stroke como string.

Alternativas descartadas

  • Conservar el CSS y el JavaScript del template Tabler/Bootstrap — mantiene la copia entera y sus plugins (jQuery incluido) al servicio de unas pocas pantallas.

Consecuencias

Los componentes son locales y editables, sin caja negra de terceros. Quedan assets sin usar en public/ que aún se copian al build, porque el recorte de public/template y public/assets no se completó.


Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).