Cómo empezar

Integra Solar en tu proyecto

Dos formas, según lo que vas a hacer: el CDN para prototipos y maquetas, o un build de Tailwind para algo que se va a usar de verdad.

Opción A

Prototipos y maquetas, vía CDN

Pegar y listo, sin compilar.

Copia este snippet en el <head> de tu HTML:
<!-- Solar · v0.8.0 · solo prototipos -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:opsz,wght@14..32,300..700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">

<link rel="stylesheet" href="https://utiliza.me/solar/assets/css/ccs-ui-kit.css">
<script src="https://cdn.tailwindcss.com"></script>
<script src="https://utiliza.me/solar/assets/js/ccs-tailwind-config.js"></script>
Solo para prototipos
El CDN de Tailwind no está pensado para producción. Si lo que armaste se va a usar de verdad, pásalo a la opción B antes de publicarlo. Este sitio carga Tailwind, los íconos y las tipografías por CDN porque es documentación; un proyecto real los aloja en su propio servidor.
Opción B

Producción, con build de Tailwind

Compila solo las clases que usas, sin depender del CDN.

Instala Tailwind y usa Solar como preset
npm install -D tailwindcss@3
// tailwind.config.js
module.exports = {
  presets: [require('./ccs-tailwind-config.js')],
  content: ['./**/*.html'],
};

Ajusta content a las carpetas de tu proyecto.

Aloja las tipografías

En producción, Inter y JetBrains Mono van en tu propio servidor, no en Google Fonts, igual que Tailwind compilado y los íconos. Descarga los archivos .woff2 variables (licencia OFL), por ejemplo de los paquetes de npm @fontsource-variable/inter y @fontsource-variable/jetbrains-mono (carpeta files/). Déjalos en /fonts/ y agrega esto al comienzo de input.css, antes de @tailwind:

/* input.css · tipografías de Solar */
@font-face {
  font-family: 'Inter';
  font-style: normal;
  font-weight: 100 900;
  font-display: swap;
  src: url('/fonts/inter-latin-opsz-normal.woff2') format('woff2');
}
@font-face {
  font-family: 'JetBrains Mono';
  font-style: normal;
  font-weight: 100 800;
  font-display: swap;
  src: url('/fonts/jetbrains-mono-latin-wght-normal.woff2') format('woff2');
}
Aloja los íconos

Los componentes de Solar usan <iconify-icon>, que en este sitio pide cada ícono a la API de Iconify. En producción, descarga iconify-icon.min.js y solar-iconos.js (los íconos que usa Solar), déjalos en /js/ y cárgalos en el <head>, en este orden. Así el HTML de los componentes funciona tal cual y no se pide nada fuera de tu sitio.

<!-- Solar · íconos alojados -->
<script src="/js/solar-iconos.js"></script>
<script src="/js/iconify-icon.min.js"></script>

Si usas un ícono que no está en solar-iconos.js, no se va a ver. Genera tu propio archivo con generar-solar-iconos.js: busca los íconos en tus .html y .js y copia solo esos.

npm i -D @iconify-json/solar @iconify-json/ph @iconify-json/mingcute @iconify-json/mynaui
node generar-solar-iconos.js ./ > js/solar-iconos.js

El generador busca el nombre completo escrito tal cual. Si armas el nombre en JavaScript (por ejemplo, con una variable), no lo encuentra: escribe esos nombres completos en un comentario del mismo archivo, como // íconos: solar:check-circle-bold solar:close-circle-bold.

Si haces pruebas automáticas con capturas: <iconify-icon> dibuja cada ícono recién cuando entra en pantalla, así que en una captura de página completa los que estaban fuera de vista salen vacíos. A quien usa el sitio no le afecta. Antes de capturar, recorre la página con scroll, o agrega el atributo noobserver a los íconos en la copia de prueba.

Compila el CSS
/* input.css */
@tailwind base;
@tailwind components;
@tailwind utilities;
npx tailwindcss -i input.css -o solar.css --minify

Mientras desarrollas, agrega --watch para que se compile solo cada vez que guardas.

Carga el CSS en tu HTML
<!-- Solar · v0.8.0 · producción -->
<link rel="stylesheet" href="/ccs-ui-kit.css">
<link rel="stylesheet" href="/solar.css">

Pasos para integrar un componente

  1. 1
    Carga Solar en tu proyecto

    Con la opción A para prototipos, o la B para producción.

  2. 2
    Abre el componente en el catálogo

    Busca el componente y entra a su vista de detalle.

  3. 3
    Copia el HTML con un click

    Usa el botón Copiar código y pégalo donde lo necesitas.

  4. Listo

    El componente se renderiza con los tokens CCS sin pasos adicionales.

¿Listo para construir?

Explora los 49 componentes del catálogo.

Ir al catálogo