Ir al contenido

Crear componentes

Los recursos viven en src/data/items/. Importa nuevas colecciones en src/data/catalog.js, el punto único que reúne el catálogo. Los ID conectan entidades sin duplicar código:

{
id: 'mi-boton',
title: 'Mi botón',
category: 'basicos',
type: 'componente',
scope: 'global', // o 'client' para un recurso exclusivo
styleIds: ['glassmorphism'],
clientIds: ['artic'],
projectIds: ['artic-platform'],
description: 'Un botón portable.',
tags: ['boton', 'acción'],
documentation: 'Importa el CSS y conecta el evento de clic.',
html: '<button class="uv-mi-boton">Acción</button>',
css: '.uv-mi-boton { padding: 1rem; }',
js: '', // opcional
}

Para agregar un estilo, crea una entrada en src/data/styles.js con ID, nombre, descripción, colores y portada. La ruta de detalle se genera automáticamente. Añade una muestra que referencie ese ID.

Para incorporar una marca, agrega sus datos a src/data/clients.js: nombre, paleta, fuentes, tokens, isotipo y estilos relacionados. Registra sus proyectos en el arreglo projects. Referencia los ID correspondientes desde los recursos. Las marcas de ejemplo son conceptuales: sustituye sus datos por los oficiales.

Los controles opcionales usan propiedades CSS prefijadas --uv- y admiten color o range. El inspector exporta los valores ajustados junto al CSS.

  1. Da a las clases un prefijo propio, como uv-mi-boton.
  2. Evita estilos globales como button { ... }.
  3. No uses librerías de terceros para algo que puede resolverse con CSS.
  4. Usa HTML semántico, foco visible y atributos ARIA cuando sean necesarios.
  5. Verifica que index.html exportado funciona sin depender de Astro.
  6. Si hay JavaScript, limítalo a la raíz del propio componente.
  7. Añade una descripción y etiquetas que faciliten la búsqueda.

Comprueba la estructura con npm run check:catalog y la compilación con npm run build.