Compatibilidad
ozi-ui está diseñado para funcionar en diferentes stacks, frameworks y entornos — desde PHP puro hasta Laravel moderno, desde Bootstrap hasta Tailwind.
Dependencias
A partir de la v2.0, ozi-ui no depende de ninguna biblioteca de terceros. El núcleo, los módulos, los componentes y los behaviors son JavaScript puro.
| Dependencia |
¿Necesaria? |
Observación |
| Ninguna |
— |
ozi-ui v2 funciona por sí solo — basta un <script src> |
| jQuery |
❌ Opcional |
Solo es necesario si activas los shims de compatibilidad con la v1 |
| Etapa de build |
❌ Opcional |
Distribuido como IIFE — Webpack, Vite y npm son prescindibles |
¿Vienes de la v1? ozi-ui v1 estaba construido sobre jQuery 3.6+. En la v2 jQuery dejó de
ser un requisito y ya no se carga en el boot. Si tu app dependía del jQuery que "venía
incluido", pasa a incluirlo por tu cuenta. Consulta la guía de migración.
Frontend
| Framework |
Soporte |
Observación |
| Livewire 4 |
✅ Nativo |
Probado con v4.2.4 — adapter con dispatch nativo en wire:model |
| Livewire 3 |
✅ Nativo |
Hooks afterRender automáticos — integración completa |
| Alpine.js |
✅ Excelente |
Consumo directo de los eventos vía x-on:ozi:change="$event.detail" |
| Vue.js |
✅ Excelente |
Los plugins JS funcionan como utilidades externas |
| React |
✅ Bueno |
Inicializa mediante useEffect tras el montaje del componente |
| Vanilla JS |
✅ Total |
Funciona sin ningún framework |
Backend
Métodos de instalación
| Método |
Descripción |
| Composer |
Instalación mediante gestor de paquetes — composer require ozi-ui/core:^2.0 |
| Manual |
Copia los archivos al proyecto y referéncialos mediante <script src="./plugins/ozi-ui/ozi.js"></script> |
| Framework |
Soporte |
Composer |
Manual |
Observación |
| Laravel 13 |
✅ Nativo |
✅ |
✅ |
Totalmente soportado |
| Laravel 12 |
✅ Nativo |
✅ |
✅ |
Totalmente soportado |
| Laravel 11 |
✅ Nativo |
✅ |
✅ |
Totalmente soportado |
| Laravel 10 |
✅ Nativo |
✅ |
✅ |
ServiceProvider, directivas Blade y ozi:check |
| Laravel 9 |
✅ Compatible |
✅ |
✅ |
Funciona con ajuste mínimo en composer.json |
| Laravel 8 |
⚠️ Parcial |
❌ |
✅ |
Requiere PHP 8.0+ y ajuste en el ServiceProvider |
| Laravel 7 |
⚠️ Parcial |
❌ |
✅ |
Solo plugins JS — sin ServiceProvider |
| Laravel 5/6 |
⚠️ Parcial |
❌ |
✅ |
Sin ServiceProvider — solo plugins JS vía <script src> |
| PHP puro |
✅ Total |
❌ |
✅ |
Funciona en cualquier proyecto PHP sin etapa de build |
| Symfony |
⚠️ Parcial |
❌ |
|
Los plugins JS funcionan — ServiceProvider no disponible |
| WordPress |
⚠️ Parcial |
❌ |
✅ |
Los plugins JS funcionan |
UI / CSS
El tema es dato, no código: variables CSS (--ozi-*) + un mapa de clases. El mismo build JS sirve cualquier tema — solo se cambia oziConf({ theme }).
| Framework |
Soporte |
Observación |
| Bootstrap 5.x |
✅ Nativo |
Estándar recomendado |
| Bootstrap 4.x |
✅ Compatible |
Configura las clases mediante oziConf() |
| Tailwind CSS 4 |
✅ Nativo |
Tema completo en la v2 — incluye su propio overrides.css |
| DaisyUI |
✅ Compatible |
Funciona sobre Tailwind — misma configuración |
| CSS propio |
✅ Total |
Tokens --ozi-* personalizables vía :root |
| Sin framework CSS |
✅ Total |
Visual propio mediante tokens CSS |
Entornos
ozi-ui v2 está escrito en sintaxis ES5 (sin transpilación), pero usa APIs de navegador modernas — fetch, WeakMap, AbortController, Element.closest y Element.animate.
| Entorno |
Soporte |
Observación |
| Navegadores modernos |
✅ Total |
Chrome, Firefox, Safari, Edge |
| Navegadores móviles |
✅ Total |
iOS Safari, Android Chrome |
| Internet Explorer 11 |
❌ |
La v2 requiere fetch/WeakMap/AbortController — usa la v1 (v1-final) si necesitas IE11 |
| Node.js (SSR) |
❌ |
Requiere DOM — no funciona en el servidor |
Resumen
|
ozi-ui v2 |
| Dependencias |
Ninguna — JS puro |
| Requisito mínimo |
Navegador moderno (fetch, WeakMap) |
| Laravel recomendado |
10, 11, 12, 13 |
| PHP recomendado |
8.2+ |
| PHP puro |
✅ Total |
| Livewire |
3 y 4 ✅ |
| Frontend |
Livewire, Alpine, Vue, React, Vanilla |
| UI |
Bootstrap, Tailwind, DaisyUI, CSS propio |
| Otros |
Symfony y WordPress ⚠️ parcial |
| Licencia |
MIT — uso libre |