first commit

README.md

@@ -0,0 +1,139 @@
+# 🧩 Laravel Vuexy Website Layout: Porto
+
+<p align="center">
+    <a href="https://koneko.mx" target="_blank">
+        <img src="https://git.koneko.mx/Koneko-ST/koneko-st/raw/branch/main/logo-images/horizontal-05.png" width="400" alt="Logo de Koneko Soluciones Tecnológicas">
+    </a>
+</p>
+
+<p align="center">
+    <a href="https://koneko.mx"><img src="https://img.shields.io/badge/Sitio%20Web-koneko.mx-blue" alt="Sitio Web"></a>
+    <a href="https://github.com/koneko-mx/laravel-koneko-layout-porto"><img src="https://img.shields.io/github/license/koneko-mx/laravel-koneko-layout-porto" alt="Licencia"></a>
+    <a href="https://github.com/koneko-mx/laravel-koneko-layout-porto/issues"><img src="https://img.shields.io/github/issues/koneko-mx/laravel-koneko-layout-porto" alt="Issues"></a>
+</p>
+
+---
+
+## 📌 Descripción
+
+**Laravel Vuexy Website Layout: Porto** es un layout profesional y modular para sitios web, diseñado para funcionar con el módulo [Vuexy Website Admin](https://github.com/koneko-mx/laravel-koneko-website-admin) dentro del ecosistema ERP de Koneko.
+
+Basado en el reconocido **template HTML Porto**, este paquete incluye soporte para más de 85 variantes visuales listas para usar, incluyendo sitios corporativos, blogs, portafolios, landings de productos y mucho más. Todo ello integrado mediante componentes Blade y bloques de contenido dinámicos.
+
+---
+
+### ⚠️ Legal
+
+Este repositorio **no incluye archivos de plantillas premium**. Para producción debes adquirir una licencia legal del template a través del siguiente enlace:
+
+👉 [https://themeforest.net/item/porto-responsive-html5-template/4106987](https://themeforest.net/item/porto-responsive-html5-template/4106987)
+
+---
+
+## 🚀 Instalación Rápida
+
+```bash
+composer require koneko/laravel-koneko-layout-porto:dev-develop
+php artisan vendor:publish --tag=vuexy-website-layout-porto-assets
+```
+
+Esto publicará los assets en:
+
+```
+/public/vendor/koneko-layout-porto/
+```
+
+---
+
+## 📦 Características
+
+* ⚡ Más de 85 plantillas Porto listas para usar
+* 🧹 Componentes Blade para cada plantilla
+* 🎨 Cambio de plantilla desde la UI de Vuexy Website Admin
+* 🖼️ Banners, widgets y secciones dinámicas
+* 🧠 Integrado con el CMS Koneko y contenido multilenguaje
+* 📁 Preparado para SCSS, Vite y optimización con Blade
+* 🔌 Diseñado para rendimiento y SEO
+
+---
+
+## 📁 Estructura de Carpetas Destacada
+
+```
+resources/
+├── views/templates/
+│   ├── accounting-1/
+│   ├── digital-agency/
+│   ├── real-estate/
+│   ├── ...
+│   └── vuexy-website-layout-porto/
+│
+├── views/templates/{template}/components/
+├── public/
+│   └── vendor/koneko-layout-porto/
+└── img/module-cover.png
+```
+
+---
+
+## 📎 Plantillas Visuales Incluidas
+
+Algunas de las variantes disponibles:
+
+* Arquitectura e Interiorismo
+* Agencia Digital (oscura y clara)
+* Finanzas y Contabilidad
+* Servicios de Limpieza
+* Iglesia, Barbería, Restaurante, Cafetería
+* Construcción y Energía Renovable
+* Educación, Boda, Portafolio, CV
+* Landing de Productos, Aplicaciones y SaaS
+* Diseños enfocados en SEO y eventos
+
+Consulta el listado completo en el directorio `views/templates/`.
+
+---
+
+## ⚙️ Integración con el Ecosistema Koneko
+
+Este layout se registra automáticamente en la interfaz de **Koneko Vuexy Admin** como un módulo visual. Desde la interfaz administrativa puedes:
+
+* Seleccionar Porto como plantilla para tu sitio
+* Configurar banners y variantes específicas
+* Activar o desactivar bloques por página
+* Usar variantes multilenguaje con soporte para `hreflang`
+
+Es totalmente compatible con los módulos `website_contents`, `website_seo_profiles` y `website_menus`.
+
+---
+
+## 🛠️ Requisitos
+
+* PHP `^8.2`
+* Laravel `^11.31`
+* [koneko/laravel-koneko-website-admin](https://github.com/koneko-mx/laravel-koneko-website-admin)
+* Node + Vite para personalización con SCSS (opcional pero recomendado)
+
+---
+
+## 📄 Licencia
+
+Este paquete se distribuye bajo la [Licencia Business Source 1.1 personalizada](LICENSE.es), con transición automática a MIT a los 3 años. Para uso comercial, redistribución o integraciones ampliadas, contacta a:
+
+📧 [opensource@koneko.mx](mailto:opensource@koneko.mx)
+    
+---
+
+## 📚 Más Información
+
+* [Módulo Website Admin](https://github.com/koneko-mx/laravel-koneko-website-admin)
+* [Core Vuexy Admin](https://github.com/koneko-mx/laravel-koneko-vuexy-admin)
+* [Documentación en inglés](README.en.md)
+* [Sitio Oficial Koneko ST](https://koneko.mx)
+* [Correo de Contacto](mailto:opensource@koneko.mx)
+
+---
+
+<p align="center">
+    Hecho con ❤️ en México por <a href="https://koneko.mx">Koneko Soluciones Tecnológicas</a>
+</p>