Saltar al contenido

Instalación

El Core se usa con dos o tres líneas en tu HTML, sin framework y sin paso de build. Gratis, licencia MIT. Esta página arma tu primera página y después explica las dos formas de tener el Core en tu proyecto.

Tu primera página en 60 segundos

Estas tres líneas, dentro del <head>, son todo lo que hace falta. La versión va fija en la URL, así que lo que se pega hoy no cambia mañana.

html
<link rel="stylesheet" href="https://taisho.design/core/0.16.0/taisho.tokens.css" integrity="sha384-+2WHAtu42BCWEq7KajKLeexi0n+E4UXhDgH4f5iQLZWhC0WJf3DNRH2uBr4FrdIV" crossorigin="anonymous">
<link rel="stylesheet" href="https://taisho.design/core/0.16.0/taisho.full.css" integrity="sha384-nXkvfhi45iBlfj6WyOwieVBV1uWh8pQaHK9ObB4RPzCC2Rsj7tXlloB4fMGH4l/9" crossorigin="anonymous">
<script type="module" src="https://taisho.design/core/0.16.0/taisho.core.js" integrity="sha384-AcLAh9bi9NFu/LxLgFXtP6pkTui6MW3eUwTLDBIxFsWjSBwiQqzxo3zTWvBjpnpE" crossorigin="anonymous"></script>

El orden importa. El tema va primero: define las variables que el CSS del sistema consulta. Después el CSS del sistema, y al final el JS de comportamiento, que se inicializa solo.

Si el CSS y el JS son de versiones distintas, el Core lo avisa una sola vez en la consola del navegador y sigue funcionando.

Se guarda esto como index.html y se abre en el navegador: aparece un título, un botón y un modal que abre y cierra. Las clases se escriben con la llave ts en el mismo elemento (class="ts button size-md variant-primary").

index.html

Para seguir, cada componente de la portada tiene su HTML para copiar; las clases disponibles están en Utilidades y su gramática, en Nombres de clases.


Las dos formas de tener el Core

La primera es la que se acaba de usar: los archivos salen del CDN. La segunda instala el paquete @taishods/core y su comando taisho, que compila el CSS con tu marca. Las dos son el mismo Core y se puede pasar de una a otra en cualquier momento.

Por CDN Con el paquete y el CLI
Qué hace faltaNada: los archivos salen del CDNNode 22.18 o más nuevo y npm
Cómo se instalaSe pegan las líneas de arribanpm i -D @taishods/core
El CSSYa compilado, con el tema del sistemaLo compila taisho generate con tu marca y, con content, sólo lo que se usa
Tu marcaTus propias variables, en un CSS después del temaTus semillas de color en taisho.config.ts
Variantes responsiveUn conjunto curado de utilidadesCualquier utilidad con cualquier screen que se escriba

Con el paquete y el CLI

Para tener los colores propios en el CSS en vez del tema del sistema, se instala el paquete y se corre el CLI desde la raíz de tu proyecto. El paquete está en npm público: no hace falta cuenta, token ni configuración previa.

bash
npm i -D @taishods/core
npx taisho init       # pregunta idioma, marca, tema, fuentes, íconos, carpeta de salida y si instalar lucide-static, y escribe taisho.config.ts
npx taisho generate   # compila tu CSS y copia el JS a esa carpeta

Tu tema

El CDN trae el Core ya compilado con el tema de TaishoDS Core. Para usar el tuyo (tus colores, radios, neutros) hay que compilarlo: el tema vive en taisho.config.ts y npx taisho generate escribe el CSS con él.

generate escribe theme.css (tus tokens), fonts.css y el CSS del sistema, y al terminar imprime las líneas <link> y <script> exactas para pegar. El JS de comportamiento queda en taisho/taisho.core.js, junto al CSS, con sólo los módulos que tu content nombra (sin content, con todos). Esa carpeta es la que se despliega con el sitio: init pregunta cuál es (propone public/taisho, static/taisho o ./taisho según el proyecto) y la guarda como out en taisho.config.ts. Los íconos salen del paquete lucide-static: init ofrece instalarlo (npx taisho init --install-icons lo instala sin preguntar) y, más tarde, se instala con npm i -D lucide-static. generate sólo avisa, con ese comando, si el código usa íconos que no se resuelven por faltar el paquete. El detalle de los comandos y el archivo de configuración está en Theming.

Durante el trabajo, npx taisho watch deja el CSS al día solo: cada vez que se guarda un archivo, la config o un ícono propio, regenera lo que cambió. Con Vite, el plugin taisho() hace lo mismo dentro del servidor de desarrollo.

Con un empaquetador

Si el proyecto ya usa Vite u otro empaquetador, el CSS y el JS se importan por nombre desde el paquete, sin copiar ni enlazar archivos: el empaquetador los incluye en lo que despliega.

js

Base y sólo los componentes que se usan

El CDN también publica el sistema partido: taisho.base.css (reset, utilidades y animaciones, sin componentes), un taisho.<componente>.css por componente y taisho.components.css con todos. Cada archivo trae sólo lo suyo, así que un componente que usa a otro necesita los dos: el Button puede mostrar un Spinner, y entonces se carga también taisho.spinner.css. Cada página de componente dice qué más cargar («También se carga», en su sección «TaishoDS Core»). Alert Dialog, Container, Field, Stack y Visually Hidden no tienen archivo propio: se arman con la base y con los componentes de su ejemplo.

base + Button + Spinner

Cuánto pesa

Todos los números de peso de la documentación salen de esta sección y de una sola medición. Medido el 2026-11-14 sobre el commit d00a144a, con la última versión publicada de cada sistema. Los pesos son KB (1 KB = 1024 bytes) con gzip nivel 9 y, entre paréntesis, brotli calidad 11; cada archivo se comprime por separado y se suman. Fuentes e íconos no cuentan.

Una página real, cada sistema en su mejor forma

Tres páginas de producto (un panel de equipo, una pantalla de formularios y una landing), cada una con los componentes oficiales de cada sistema y con la misma lista de piezas. Cada sistema se usa como lo recomienda: con purga o por módulos cuando puede. El marcado de los otros sistemas lo armó el autor de esta medición a partir de su documentación, y la página de TaishoDS usa los textos de sus ejemplos oficiales. Una instancia de cada componente, sin proyecto completo.

Sistema y forma de uso Panel (KB gzip y brotli) Formularios (KB gzip y brotli) Landing (KB gzip y brotli)
DaisyUI 5.8.0: CSS con purga; Cally para el calendario. En Formularios suma Cally.13,1 (11,3)21,5 (19,1)8,1 (7,2)
TaishoDS Core: Modo compilado: CSS a demanda con tema podado y sólo los módulos de JS que la página usa38,3 (32,8)44,5 (38,0)15,8 (13,5)
Bootstrap 5.3.9: Sass con sólo los módulos usados y JS por módulo. En Formularios suma flatpickr.48,7 (39,1)47,2 (38,2)23,5 (17,2)
Flowbite 4.0.2: CSS con purga; flowbite.min.js completo40,7 (35,6)40,6 (35,5)40,2 (35,1)
UIkit 3.25.31: uikit-core y los componentes usados. En Formularios suma flatpickr.67,6 (57,9)80,3 (69,2)63,2 (54,0)
Web Awesome 3.14.0 (gratuita): Con bundler: cada componente usado por separado101,8 (79,2)99,5 (76,4)59,2 (47,7)
Preline 5.1.0: CSS con purga; preline.js completo. En Formularios suma lodash.112,4 (91,5)138,5 (114,6)111,3 (90,5)

En gzip, TaishoDS Core queda 2.º en el panel, 3.º en formularios y 2.º en la landing, entre 7 sistemas; en brotli, 2.º, 3.º y 2.º. Por delante en gzip, página por página: Panel: DaisyUI; Formularios: DaisyUI y Flowbite; Landing: DaisyUI. DaisyUI queda adelante porque resuelve casi todo con CSS y sólo suma JS para el calendario.

El archivo completo (CDN)

Lo que baja quien carga el archivo de distribución de cada sistema, sin purga ni módulos. El completo de TaishoDS Core trae todos los componentes y todo el vocabulario de utilidades.

Sistema y archivos CSS (KB gzip) JS (KB gzip) Total, gzip (brotli) Total sin comprimir
Bootstrap 5.3.9: bootstrap.min.css y bootstrap.bundle.min.js30,023,353,3 (42,9)305,7
Flowbite 4.0.2: flowbite.min.css y flowbite.min.js26,728,855,5 (45,6)317,5
DaisyUI 5.8.0: daisyui.css, sin JS65,6—65,6 (41,3)1154,4
TaishoDS Core: taisho.tokens.css, taisho.full.css y la base de taisho.core.js66,215,181,3 (55,6)775,4
UIkit 3.25.31: uikit.min.css y uikit.min.js30,352,282,4 (69,9)427,9
Web Awesome 3.14.0 (gratuita): todos los componentes en un solo archivo, con bundler13,8193,3207,1 (155,0)897,1
Web Awesome 3.14.0 (gratuita): CDN con autocargador, según la página13,884,0 a 169,697,8 a 183,4 (80,5 a 152,9)—

Como archivo completo, TaishoDS Core queda 4.º de 6 en gzip y 4.º en brotli. Por delante en gzip: Bootstrap, Flowbite y DaisyUI. Sólo su CSS (tema y completo) pesa 66,2 KB en gzip y 726,0 KB sin comprimir, que el navegador tiene que interpretar.

El JS de TaishoDS Core

El JS viene partido: la base más el módulo de cada componente pesado, que se baja sólo si la página lo usa. En el Modo directo se suma lo que el navegador pide de verdad; en el Modo compilado, taisho generate arma un solo archivo con los módulos que el contenido nombra.

JS de TaishoDS Core, según lo que use la página JS (KB gzip y brotli)
Modo directo: la base (Tabs, Accordion, Menu, Toast… y ningún componente pesado)15,1 (13,6)
Modo directo: la base y DatePicker26,9 (24,2)
Modo directo: la base y Select o Combobox21,4 (19,2)
Modo directo: la base y paleta de comandos18,6 (16,7)
Modo directo: la base y NumberInput18,8 (16,9)
Modo directo: la base y Slider18,2 (16,4)
Modo directo: la base y Table17,5 (15,7)
Modo directo: la base y Pagination17,4 (15,5)
Modo directo: la base y FileUpload17,3 (15,5)
Modo directo: la base y validación de campos (markInvalid)16,9 (15,1)
Modo directo: la base y los 10 módulos pesados (17 archivos)43,4 (38,9)
Modo compilado: sin ningún módulo3,5 (3,1)
Modo compilado: una página sólo con Tabs4,8 (4,3)
Modo compilado: una página con DatePicker13,2 (12,0)
Modo compilado: todos los módulos34,2 (30,1)

El CSS de TaishoDS Core

Para pesar menos hay dos caminos: cargar la base y sólo los componentes que se usan desde el CDN, o compilar con taisho generate y content, que deja en el CSS sólo lo que tus archivos usan.

CSS de TaishoDS Core, según cómo se cargue CSS (KB gzip y brotli) Sin comprimir
Modo directo: tema y CSS completo66,2 (42,0)726,0
Modo compilado: el panel de referencia, con el tema19,0 (15,4)149,3
Modo compilado: la pantalla de formularios de referencia, con el tema18,8 (15,1)164,7
Modo compilado: la landing de referencia, con el tema9,8 (8,2)71,5
Modo compilado: sólo la base, con el tema2,1 (1,7)6,8
Modo compilado: una página con DatePicker, con el tema11,4 (9,4)93,7
Modo compilado: los 56 componentes juntos, con el tema28,5 (22,4)250,4

No se ve / no anda

Si se pegó el HTML y algo no responde, casi siempre es una de estas cinco. Conviene revisarlas en este orden.

Qué ves Por qué Cómo se arregla
Todo sale como texto plano, sin estilosFalta la llave ts en el elemento.Se escribe class="ts button" y no sólo el nombre de la clase. La llave ts va en cada elemento que lleva clases del sistema. En desarrollo local (localhost), si el CSS del Core está cargado y ningún elemento lleva ts, el JS del Core lo avisa en la consola.
Hay estilos, pero sin colores ni tipografía del sistemaFalta el tema o va después del CSS del sistema.taisho.tokens.css va primero, siempre: define las variables que el CSS del sistema consulta.
Un componente se ve a mediasSe cargó el CSS partido y falta el archivo de su componente o el de otro que usa.La sección «TaishoDS Core» de cada componente dice qué más cargar («También se carga»). El Button, por ejemplo, pide taisho.spinner.css. También sirve cargar taisho.full.css, que trae todo.
El Modal o el Drawer no abren al tocar el botónEl navegador no soporta invoker commands (Safari anterior a 26.2, Firefox anterior a 144), o el commandfor del botón no coincide con el id del dialog.Conviene revisar que command="show-modal" y commandfor="<id del dialog>" estén bien escritos. En un navegador sin invoker commands, el JS del Core ejecuta los comandos: comprobar que se cargó taisho.core.js, o abrir con showModal() desde el JS propio (ver Soporte de navegadores).
Las pestañas, el acordeón, el Select o el Toast no respondenFalta el <script> del Core, o no es type="module".Se agrega <script type="module" src="…/taisho.core.js"></script>. Se inicializa solo.

Para saber qué JS necesita cada componente y cómo se reacciona a lo que pasa, ver Comportamiento. Para los navegadores que soporta, Soporte de navegadores.


Servir el JS desde tu propio sitio

taisho.core.js es la base del JS; los componentes pesados viven en archivos al lado. Qué implica:

  • Copiar la carpeta de la versión, no un archivo. Al servir el JS desde otro lugar, taisho.core.js pide los módulos de los componentes pesados a los archivos que tiene al lado: se copia toda la carpeta /core/<versión>/ o se usa taisho generate.
  • integrity cubre sólo el archivo que enlaza cada etiqueta. El navegador verifica ese archivo; los módulos que taisho.core.js carga después con import() no entran en el hash del <script>. Las líneas llevan crossorigin="anonymous" porque el hash de un archivo de otro origen sólo se comprueba con CORS, y el CDN lo permite.
  • Cargar un solo taisho.core.js. Con taisho generate y content, si el core.js del paquete queda junto a taisho/taisho.core.js, cada click se procesa dos veces. Debe cargarse sólo el generado.
  • init() devuelve una promesa que se cumple cuando los módulos de la página ya cargaron.