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).