Todo-en-uno, self-hosted y modular para hogares compartidos.
Núcleo · Módulos · Crear un módulo · Filosofía
Convive es una plataforma para gestionar la vida de un hogar compartido (pareja, piso, familia): finanzas, tareas, listas de compra, recurrencias, presupuestos, analíticas y más, todo en una sola app autoalojada en tu red local.
El ecosistema se compone de un núcleo y un conjunto de módulos que se instalan o desinstalan desde la propia app. Cada módulo vive en su propio repositorio dentro de esta organización y publica releases versionadas que el núcleo descarga e instala dinámicamente.
| Repositorio | Descripción |
|---|---|
| Convive | App principal: auth, hogares, tareas, sistema de plugins, UI base. React + Node/Express + SQLite. |
Cada módulo se instala desde la app (Ajustes → Módulos) o por CLI. Todos exponen una API REST montada en /api/modules/<slug> y, opcionalmente, una UI cargada dinámicamente vía import map.
| Módulo | Qué hace |
|---|---|
| module-expenses | Gastos con splits (50/50, equal, %, custom), recibos y ciclo claim/confirm. |
| module-recurring-expenses | Gastos recurrentes con cron nocturno y ejecución manual. |
| module-shopping | Listas de compra múltiples, items y conversión "compra → gasto". |
| module-settlements | Liquidaciones manuales y sugerencia óptima de pagos. |
| module-budgets | Presupuestos por categoría con barras de progreso (verde/ámbar/rojo). |
| module-analytics | Análisis por categoría, tendencia y comparativas. |
| module-telegram-notifications | Bot de Telegram para avisos y recordatorios. |
¿Quieres añadir funcionalidad nueva al ecosistema? Parte de la plantilla:
- module-template — esqueleto listo con manifest, server, UI y workflow de release.
Pasos básicos:
- Usa el template para crear un repo nuevo bajo
convive-ecosystem/module-<nombre>. - Implementa endpoints en
server/y, si aplica, UI enclient/. - Publica un release con tag
vX.Y.Z— el núcleo lo detectará e instalará desde la app.
El contrato de los módulos (manifest, hooks, permisos) está documentado en el README del núcleo.
- Self-hosted, no cloud — tus datos viven en tu casa, en un LXC/VM (pensado para Proxmox), accesible solo desde la LAN.
- Privacidad por defecto — sin telemetría, sin terceros, sin cuentas externas.
- Modular — el núcleo es pequeño; cada feature es un módulo opt-in que puedes instalar, desinstalar o reemplazar.
- Stack moderno y aburrido — React + Node + SQLite, todo en Docker. Sin frameworks exóticos, sin lock-in.
- PWA — instalable desde el móvil, con Web Push opcional.
git clone https://github.com/MiguelJiRo/Convive.git
cd Convive
cp .env.example .env
docker compose up -d --buildServido por Caddy en https://convive.lan. Para arranque sin Docker (modo dev) consulta el README del núcleo.
- Bugs y mejoras del núcleo → issues en MiguelJiRo/Convive.
- Bugs de un módulo → issues en el repo del módulo correspondiente.
- Módulo nuevo → parte de
module-template. - PRs bienvenidas en cualquier repo del ecosistema.
Todos los repos del ecosistema usan MIT salvo que se indique lo contrario en el repo concreto.
