
# Librería CSS — Universidad de Concepción

Esta librería proporciona estilos oficiales reutilizables para proyectos de la Universidad de Concepción. Permite instalarse como dependencia y utilizar una hoja completa compilada, o bien construir un output personalizado seleccionando hojas concretas.

**Visión y objetivos**
- Ofrecer una fuente única y consistente de estilos para sitios web de la universidad.
- Permitir integración fácil como dependencia (`npm`/`yarn`) y uso manual.

**Plan general (etapas principales)**
- Documentar visión y objetivos en README.
- Especificar opciones de instalación.
- Agregar guía de uso rápido (hoja compilada).
- Explicar cómo generar output personalizado.
- Describir estructura del paquete y convenciones.
- Incluir ejemplos.
- Detallar publicación en npm y versionado.
- Configurar CI: build, lint y tests.
- Añadir guía de contribución y licencia.

**Instalación**
Se publicará el paquete en npm para instalarlo como dependencia de proyectos:

```
npm install @udec/udec-frontend-library
```

O con Yarn:

```
yarn add @udec/udec-frontend-library
```

También se podrá descargar la hoja compilada desde la sección `dist/` del paquete si se prefiere incluirla manualmente.

**Uso rápido**
- Importar la hoja compilada en el HTML:

```
<link rel="stylesheet" href="node_modules/@udec/udec-frontend-library/dist/udec.css">
```

**Build personalizado**
Proveeremos un mecanismo para generar un CSS final seleccionando módulos (por ejemplo: variables, layout, components) usando herramientas como PostCSS/Sass y scripts de build. La guía detallada explicará cómo:
- instalar dependencias de desarrollo,
- importar solo los archivos necesarios,
- ejecutar el script de compilación para producir un CSS a medida.

**Estructura del paquete (propuesta)**
- `src/` — archivos fuente de la librería
    - `fonts/` — tipográfias corporativas
    - `icons/` — íconos en formato svg
    - `img/` — logo corporativo e imágenes de apoyo
    - `js/` — scripts de componentes
        - `index.js` — bundle de scripts
    - `scss/` — estilos de la librería
        - `index.scss` — bundle de estilos
- `dist/` — assets compilados por webpack encore
    - `fonts/` — tipográfias corporativas
    - `udec-scripts.js`
    - `udec-styles.css`
- `examples/` — ejemplos y snippets
- `package.json` — scripts de build, test y publish

**Documentación**
- La documentación estará disponible en la sección Front-end del kit digital.

**Publicación y versionado**
- SemVer para releases.
- Publicación en npm con tags (`latest`, `beta`).

**CI / Calidad**
- Pipeline que ejecute build, lint y pruebas visuales básicas antes de publicar.

**Contribuir**
Se incluirá un `CONTRIBUTING.md` con guía para desarrollar, revisar PRs y mantener convenciones (naming, commits, pruebas).

