Crear componentes
Incorporar un recurso
Sección titulada «Incorporar un recurso»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.
Reglas prácticas
Sección titulada «Reglas prácticas»- Da a las clases un prefijo propio, como
uv-mi-boton. - Evita estilos globales como
button { ... }. - No uses librerías de terceros para algo que puede resolverse con CSS.
- Usa HTML semántico, foco visible y atributos ARIA cuando sean necesarios.
- Verifica que
index.htmlexportado funciona sin depender de Astro. - Si hay JavaScript, limítalo a la raíz del propio componente.
- 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.