Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

financial-dashboard

Firefly Personal Financial Dashboard es una aplicación web interactiva construida con Next.js 16.2 y React, optimizada para móviles, que conecta directamente a Firefly III para visualizar el saldo disponible seguro (safe-to-spend), comparar gastos acumulados vs ritmo anterior mediante gráficos Chart

Ficha actualizada 29 sept 2026, 21:41 · upstream 29 sept 2026, 21:25 · release v0.1.1

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es financial-dashboard

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

El dashboard permite analizar el ingreso disponible restando facturas pendientes y estados de cuenta hasta el próximo día de pago. Incluye un ledger agrupado por tipo de cuenta (cuentas corrientes, ahorros, tarjetas) con estados individuales de actividad.

La integración con Firefly III se configura vía UI o variables de entorno (.env.local), almacenando preferencias como fechas de estado y vencimiento en notas JSON de las cuentas. Soporta autenticación por PAT y cuenta solo activos con rol Credit Card para pagos automáticos.

Distribuido como imagen Docker multiarquitectura (linux/amd64, linux/arm64) en GHCR, no requiere código fuente local. Incluye persistencia segura de contraseña en ./data y configuración inicial obligatoria de sesión.

CASOS DE USO
  • Visualizar ritmo de gasto diario vs ciclo anterior mediante línea interactiva
  • Gestionar cola de transacciones sin categoría de los últimos 7 días con actualización directa a Firefly III
  • Configurar reglas de pago para tarjetas: cálculo completo o mínimo, fechas de estado y vencimiento
  • Monitorear cuentas agrupadas por tipo (asset/liability) con estados individuales
  • Desplegar en servidor propio sin necesidad de Node.js local usando imagen precompilada
PUNTOS DESTACADOS
  • Docker multiarquitectura listo para producción en GHCR
  • Integración nativa con Firefly III Core v1 API
  • Optimización móvil-first con Tailwind CSS y glass-card system
  • Persistencia de preferencias en metadatos JSON de cuentas
  • Autenticación por PAT configurable vía UI o .env
  • Licencia GPLv3 abierta
PRECAUCIONES
  • Requiere Firefly III activo con al menos una cuenta asset
  • Las tarjetas deben tener rol Credit Card en Firefly III
  • Configuración inicial obligatoria de contraseña de sesión
  • Dependencia de Chart.js para visualización gráfica
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Home DashboardAccounts OverviewAccount SettingsRecent ActivityUpcoming Payments
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU2 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Usar docker compose con .env.local (SESSION_SECRET generado con openssl). Puerto 3001:3000. Persistir volumen dashboard_data. Acceso inicial en http://localhost:3001 con creación de contraseña obligatoria.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsReactNode.js
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
30013000
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.