title: "Addendum 14 — Aplicación Móvil PWA + Capacitor (WS11)" date: "2026-08-31" author: "GoWeBa Platform Team" tags: ["pwa", "mobile", "capacitor", "service-worker", "offline", "native"]
Addendum 14 — Aplicación Móvil PWA + Capacitor
Descripción General
GoWeBa es ahora una Progressive Web App (PWA) completa, instalable en cualquier dispositivo móvil o computadora de escritorio. Con la integración de Capacitor, la aplicación también puede compilarse como app nativa para iOS y Android y distribuirse a través del App Store y Google Play.
Service Worker
Un Service Worker inteligente gestiona el caché y la funcionalidad sin conexión:
| Estrategia | Recursos | Comportamiento |
|---|---|---|
| Cache-first | CSS, JS, imágenes, fuentes | Carga instantánea desde caché, actualización en segundo plano |
| Network-first | Llamadas a la API (/api/) | Datos actualizados, caché como respaldo cuando no hay conexión |
| Offline fallback | Páginas HTML | Página sin conexión dedicada cuando no hay red ni caché |
Pre-caché (App Shell)
Los recursos críticos se almacenan en caché durante la instalación:
- Página de inicio (
/) - Dashboard (
/dashboard) - Página sin conexión (
/offline) - Íconos y manifiesto
Modo Sin Conexión
Cuando el usuario pierde la conexión:
- Las páginas visitadas anteriormente siguen siendo accesibles desde el caché
- Los datos de la API obtenidos recientemente se sirven desde el caché
- Si no hay caché disponible, se muestra una página sin conexión dedicada con un botón "Reintentar"
Instalación de la PWA
La app puede instalarse directamente desde el navegador:
- Móvil: Banner "Agregar a pantalla de inicio" o desde el menú del navegador
- Escritorio: Botón de instalación en la barra de direcciones (Chrome, Edge)
Accesos Directos Rápidos
Una vez instalada, la app ofrece accesos directos:
- 📊 Dashboard — Acceso directo
- 👥 Contactos — Gestión de contactos
- 💬 Conversaciones — Mensajería unificada
Notificaciones Push
El Service Worker soporta notificaciones push:
- Recepción en segundo plano incluso cuando la app está cerrada
- Clic en la notificación → abre la página correspondiente
- Ícono y marca de GoWeBa
Capacitor — Aplicaciones Nativas
Con Capacitor (Ionic), GoWeBa puede compilarse como apps nativas:
| Plataforma | ID de App | Estado |
|---|---|---|
| iOS | com.goweba.app | Lista para compilar |
| Android | com.goweba.app | Lista para compilar |
Funciones Nativas Disponibles
- Notificaciones push nativas (APNs / FCM)
- Pantalla de bienvenida personalizada
- Barra de estado integrada
- Acceso a cámara, geolocalización y almacenamiento
- Retroalimentación háptica
Configuración Técnica
Manifest: /manifest.json
Service Worker: /sw.js (scope: /)
Capacitor Config: capacitor.config.ts
Offline page: /offline
Requisitos para la Compilación Nativa
- Instalar Capacitor CLI:
npm install @capacitor/cli @capacitor/core - Agregar plataformas:
npx cap add ios/npx cap add android - Sincronizar:
npx cap sync - Abrir en el IDE nativo:
npx cap open ios/npx cap open android
Addendum 14 — Agosto 2026 — Workstream 11 (Mobile PWA + Capacitor)