christmas-countdown
Cuentagotas navideño autoalojado construido con Next.js y React. Incluye diseño festivo, nieve interactiva en Canvas y lógica de fechas específica. Despliegue simplificado vía Docker multi-arquitectura sin dependencias externas ni rastreo.
Ficha actualizada 25 sept 2026, 0:45 · upstream 25 sept 2026, 0:38 · release sin release detectada
Qué es christmas-countdown
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio ofrece una solución autoalojada para visualizar el tiempo restante hasta Navidad y Año Nuevo. Construido con Next.js y React, la aplicación genera una exportación estática que incluye fuentes y lógica de cuenta atrás en el momento del build, eliminando la necesidad de un servidor Node.js en tiempo de ejecución.
El diseño es festivo, utilizando colores rojo y verde, con una capa personalizada de nieve generada en Canvas que reacciona al cursor. El comportamiento cambia según la fecha: muestra días restantes hasta Navidad, mensajes específicos para el 25 de diciembre o el 31, y transiciones visuales hacia el Año Nuevo con paleta dorada y champán.
Desde un punto de vista técnico, la imagen Docker está servida por nginx (versión no privilegiada) ejecutándose como usuario no root, con cabeceras de seguridad configuradas. El proyecto incluye una suite de pruebas automatizada con Vitest y Playwright para validar la lógica de fechas y el renderizado visual en cada fase del ciclo festivo.
- Visualización personal de cuenta atrás navideña en servidores domésticos o VPS.
- Página web estática segura sin publicidad ni analíticas externas.
- Demostración de despliegue Docker multi-arquitectura (amd64/arm64).
- Ejemplo de aplicación Next.js con lógica de fechas dinámica y renderizado estático.
- Construcción estática integrada en la imagen Docker mediante next build.
- Seguridad reforzada con nginx unprivileged, cabeceras CSP y ejecución no root.
- Efectos visuales personalizados (nieve en Canvas) sin librerías de terceros.
- Pruebas exhaustivas de lógica de fechas y renderizado mediante Playwright.
- Soporte nativo para arquitecturas amd64 y arm64/v8 sin QEMU.
- Requiere despliegue en contenedor Docker, no soporta ejecución directa sin envolverlo.
- No incluye base de datos; toda la lógica depende del tiempo del sistema o fechas hardcodeadas en el build.
- La imagen depende de un registro externo (Docker Hub) para obtener las versiones.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Ejecutar docker run -d --name christmas-countdown -p 8080:8080 modem7/christmas-countdown. Verificar disponibilidad mediante /healthz en el endpoint de salud. Asegurar que el puerto 8080 esté libre y mapeado correctamente al host. La imagen soporta múltiples arquitecturas, por lo que se puede usar en entornos x86_64 o ARM (Raspberry Pi).
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.