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.
<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").
<!doctype html>
<html lang="es">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Mi primera página con TaishoDS</title>
<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>
</head>
<body class="ts flex flex-col items-start gap-base p-double">
<h1 class="ts type-heading-36">Hola, TaishoDS</h1>
<button
type="button"
class="ts button size-md variant-primary"
commandfor="confirmar"
command="show-modal"
>
Invitar a Ana Torres
</button>
<dialog id="confirmar" closedby="any" class="ts modal-dialog" aria-labelledby="confirmar-titulo">
<div class="ts modal size-md">
<div class="ts modal-header">
<h2 id="confirmar-titulo" class="ts modal-title">Invitar a Ana Torres al equipo</h2>
</div>
<div class="ts modal-body">
<p class="ts type-copy-14">Va a poder ver y editar los proyectos de Producción y Staging.</p>
</div>
<div class="ts modal-footer">
<button type="button" class="ts button size-md variant-secondary" commandfor="confirmar" command="close">
Cancelar
</button>
<button type="button" class="ts button size-md variant-primary" commandfor="confirmar" command="close">
Invitar
</button>
</div>
</div>
</dialog>
</body>
</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 falta | Nada: los archivos salen del CDN | Node 22.18 o más nuevo y npm |
| Cómo se instala | Se pegan las líneas de arriba | npm i -D @taishods/core |
| El CSS | Ya compilado, con el tema del sistema | Lo compila taisho generate con tu marca y, con content, sólo lo que se usa |
| Tu marca | Tus propias variables, en un CSS después del tema | Tus semillas de color en taisho.config.ts |
| Variantes responsive | Un conjunto curado de utilidades | Cualquier 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.
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 carpetaTu 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.
import '@taishods/core/css/tokens/taisho.css'; // el tema del sistema
import '@taishods/core/css/taisho.full.css'; // el CSS completo
import '@taishods/core/core'; // el comportamientoBase 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.
<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.base.css" integrity="sha384-ER3lrhMGoEY9mBk/2OKiayBP3sskMseS0/TQx/8AUwdbTdXobJibDFHXEPUgas+1" crossorigin="anonymous">
<link rel="stylesheet" href="https://taisho.design/core/0.16.0/taisho.button.css" integrity="sha384-cw5CTt2Zg3772JB5Ffjrde2qe/guR3olNStr5G/+zkPkImarYYJLgrNaRHXNlkRF" crossorigin="anonymous">
<link rel="stylesheet" href="https://taisho.design/core/0.16.0/taisho.spinner.css" integrity="sha384-mM/MZmwRgOT+tqz74IW4dmmnBkr7NEQnSO+6l0J0pjcstplnveX1or1FzryGAh4D" crossorigin="anonymous">
<script type="module" src="https://taisho.design/core/0.16.0/taisho.core.js" integrity="sha384-AcLAh9bi9NFu/LxLgFXtP6pkTui6MW3eUwTLDBIxFsWjSBwiQqzxo3zTWvBjpnpE" crossorigin="anonymous"></script>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 usa | 38,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 completo | 40,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 separado | 101,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.js | 30,0 | 23,3 | 53,3 (42,9) | 305,7 |
| Flowbite 4.0.2: flowbite.min.css y flowbite.min.js | 26,7 | 28,8 | 55,5 (45,6) | 317,5 |
| DaisyUI 5.8.0: daisyui.css, sin JS | 65,6 | — | 65,6 (41,3) | 1154,4 |
| TaishoDS Core: taisho.tokens.css, taisho.full.css y la base de taisho.core.js | 66,2 | 15,1 | 81,3 (55,6) | 775,4 |
| UIkit 3.25.31: uikit.min.css y uikit.min.js | 30,3 | 52,2 | 82,4 (69,9) | 427,9 |
| Web Awesome 3.14.0 (gratuita): todos los componentes en un solo archivo, con bundler | 13,8 | 193,3 | 207,1 (155,0) | 897,1 |
| Web Awesome 3.14.0 (gratuita): CDN con autocargador, según la página | 13,8 | 84,0 a 169,6 | 97,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 DatePicker | 26,9 (24,2) |
| Modo directo: la base y Select o Combobox | 21,4 (19,2) |
| Modo directo: la base y paleta de comandos | 18,6 (16,7) |
| Modo directo: la base y NumberInput | 18,8 (16,9) |
| Modo directo: la base y Slider | 18,2 (16,4) |
| Modo directo: la base y Table | 17,5 (15,7) |
| Modo directo: la base y Pagination | 17,4 (15,5) |
| Modo directo: la base y FileUpload | 17,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ódulo | 3,5 (3,1) |
| Modo compilado: una página sólo con Tabs | 4,8 (4,3) |
| Modo compilado: una página con DatePicker | 13,2 (12,0) |
| Modo compilado: todos los módulos | 34,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 completo | 66,2 (42,0) | 726,0 |
| Modo compilado: el panel de referencia, con el tema | 19,0 (15,4) | 149,3 |
| Modo compilado: la pantalla de formularios de referencia, con el tema | 18,8 (15,1) | 164,7 |
| Modo compilado: la landing de referencia, con el tema | 9,8 (8,2) | 71,5 |
| Modo compilado: sólo la base, con el tema | 2,1 (1,7) | 6,8 |
| Modo compilado: una página con DatePicker, con el tema | 11,4 (9,4) | 93,7 |
| Modo compilado: los 56 componentes juntos, con el tema | 28,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 estilos | Falta 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 sistema | Falta 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 medias | Se 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ón | El 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 responden | Falta 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.jspide los módulos de los componentes pesados a los archivos que tiene al lado: se copia toda la carpeta/core/<versión>/o se usataisho generate. integritycubre sólo el archivo que enlaza cada etiqueta. El navegador verifica ese archivo; los módulos quetaisho.core.jscarga después conimport()no entran en el hash del<script>. Las líneas llevancrossorigin="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. Contaisho generateycontent, si elcore.jsdel paquete queda junto ataisho/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.