odio-pwa
PWA para gestionar múltiples instancias de odio-api desde una interfaz unificada, permitiendo descubrimiento local, control de estado en tiempo real y navegación profunda mediante deep linking.
Ficha actualizada 28 sept 2026, 8:44 · upstream 28 sept 2026, 8:29 · release v0.5.4
Qué es odio-pwa
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
odio-pwa es una Progressive Web App diseñada para centralizar el control de varias instancias de odio-api en tu red local. Permite añadir, editar y eliminar nodos manualmente, persistiendo la configuración en localStorage o sincronizando con GitHub Releases. Soporta instalación como PWA nativa, funcionando offline con app shell cacheado y ofreciendo una experiencia fluida sin necesidad de servidor backend adicional.
La aplicación utiliza Svelte 5 con runes para un estado reactivo eficiente, Vite para el desarrollo rápido y svelte-spa-router para deep linking basado en hash. Incluye detección automática de soporte SSE para actualizaciones en tiempo real, con fallback a polling HTTP si no está disponible. La interfaz carga cada instancia mediante iframe en pantalla completa, con barra superior compacta para cambiar entre nodos online rápidamente.
El despliegue es sencillo: Docker multi-architectura o servidor estático con rewrite SPA. Incluye tema oscuro responsivo, indicadores de estado detallados (CORS, mixed content) y actualizaciones automáticas desde GitHub. Compatible con Node.js >= 18 y sin dependencias complejas.
- Centralizar el control de múltiples instancias odio-api en una sola interfaz unificada
- Profundizar en instancias específicas mediante deep linking directo (QR, URL compartida)
- Monitorizar estado en tiempo real con fallback automático a polling si SSE no está disponible
- Desplegar como PWA instalable o servidor estático sin backend adicional
- Soporte nativo para Server-Sent Events (SSE) con fallback automático a polling HTTP cada 30s
- Deep linking robusto basado en hash (#/i/<host>/<port>) sin necesidad de servidor backend
- Detección automática de problemas CORS y mixed content con indicadores visuales claros
- PWA instalable con app shell cacheado y funcionamiento offline parcial (lista de instancias)
- Actualizaciones automáticas desde GitHub con indicador visual en la interfaz
- Dependencia crítica de CORS en las instancias odio-api para probes de estado y SSE
- Bloqueo estricto de mixed content en Safari iOS/macOS sin workaround disponible
- Persistencia limitada a localStorage (sin sincronización automática con backend externo)
- Requiere Node.js >= 18 o contenedor Docker preconfigurado para despliegue
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar con Docker: docker run -d -p 8080:80 ghcr.io/b0bbywan/odio-pwa:latest. Para servidor estático, usar nginx con rewrite de rutas desconocidas a /index.html y servir sw.js con Cache-Control: no-cache. Servir sobre HTTP en LAN para evitar mixed content; HTTPS requiere configuración CORS explícita en odio-api.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.