Instalacion
Instala Nuvex UI, registra el plugin y carga los estilos base para dejar tu proyecto listo antes de pasar a componentes, theming o layout.
Antes de empezar
- Vue 3 o Nuxt 4.
- Un proyecto ya creado.
- Sass instalado si vas a importar framework.scss.
Elige tu punto de partida
La instalacion base es corta, pero el archivo que debes tocar cambia segun tu stack.
Instala el paquete
Elige el gestor de paquetes que uses en tu proyecto. Si vas a importar framework.scss, instala tambien sass.
Si omites sass, la importacion de nuvex-ui/framework.scss fallara en tiempo de build.
Registro minimo en Vue + Vite
En una app Vue, registra el plugin en main.ts y carga primero styles.css y despues framework.scss.
src/main.ts
Registro minimo en Nuxt
En Nuxt, registra el plugin en app/plugins/nuvex-ui.ts y carga los estilos desde nuxt.config.ts.
Este es el setup minimo para instalar la libreria. Persistencia de tema, SSR fino y storage custom deben vivir en una guia posterior de integracion o theming.
app/plugins/nuvex-ui.ts
nuxt.config.ts
Prueba un primer componente
Antes de seguir con theming o layout, confirma que la libreria ya renderiza un componente simple.
Verifica la instalacion
Usa esta lista para confirmar que el setup base quedo correcto antes de pasar a otras guias.
- La app compila sin errores de Sass.
- El primer componente se ve estilizado y no como HTML sin formato.
- Un EButton se renderiza sin warnings de componente no registrado.
- Las clases de framework y el acabado base de los componentes ya se reflejan si importaste framework.scss.
Problemas comunes
Estos errores de setup suelen aparecer al instalar la libreria por primera vez y conviene resolverlos antes de seguir.
framework.scss no compila
Instala sass en tu proyecto antes de importar nuvex-ui/framework.scss.
Los estilos no se ven como esperas
Verifica el orden de carga: primero nuvex-ui/styles.css y despues nuvex-ui/framework.scss.
Los componentes no aparecen
Confirma que registraste NuvexUI con app.use(NuvexUI) o defineNuxtPlugin.
Mis variables Sass no se aplican
Si vas a personalizar framework.scss, define tus variables antes de importar el framework desde tu hoja global o desde la configuracion Sass del proyecto.
Siguiente paso recomendado
Con la instalacion base resuelta, el siguiente paso depende de si quieres probar componentes, estructurar pantallas o personalizar tema.