Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

wedding-qr-album

Álbum compartido auto-alojado para bodas y eventos. Los invitados suben fotos/videos desde móvil vía QR sin app ni registro. Datos en tu servidor, exportación ZIP completa.

Ficha actualizada 22 sept 2026, 16:14 · upstream 9 sept 2026, 14:42 · release v1.0.0

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es wedding-qr-album

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

Wedding QR Album es una aplicación web auto-alojada diseñada específicamente para compartir fotografías de eventos como bodas, cumpleaños o reuniones familiares. Los invitados escanean un código QR y suben directamente fotos y videos desde cualquier navegador móvil sin instalar aplicaciones ni crear cuentas.

La arquitectura utiliza SvelteKit con Node.js, SQLite para persistencia y Caddy como proxy inverso con certificados TLS automáticos vía Let's Encrypt. El sistema procesa imágenes mediante sharp (generando versiones optimizadas) y videos con ffmpeg, incluyendo soporte nativo para archivos HEIC de iPhone.

El panel de administración permite gestionar invitados, editar metadatos del evento, imprimir códigos QR personalizados y exportar todo el contenido en formato ZIP. La solución está licenciada bajo MIT y se recomienda desplegar en servidores Linux con Docker o Node.js local.

CASOS DE USO
  • Bodas: Invitados suben fotos desde móvil sin app ni registro mediante QR
  • Cumpleaños familiares: Crear álbum compartido rápido sin gestión de cuentas
  • Eventos corporativos: Capturar momentos en eventos internos con exportación ZIP
  • Reuniones sociales: Compartir recuerdos sin depender de servicios cloud externos
PUNTOS DESTACADOS
  • Sin aplicación móvil ni registro obligatorio para los invitados
  • Código QR integrado y generación automática de certificados TLS
  • Exportación completa del álbum en ZIP con resolución original
  • Soporte nativo para archivos HEIC de iPhone y videos hasta 60s
  • Panel de administración completo sin rebuild del proyecto
  • Datos almacenados localmente, no en servidores de terceros
PRECAUCIONES
  • Videos limitados a 60 segundos por archivo
  • SQLite no escalable para miles de usuarios concurrentes
  • Dependencia externa de ffmpeg y libheif para procesamiento
  • Sin autenticación real, solo cookies con COOKIE_SECRET
  • Requiere Node.js 22 o entorno Docker compatible
01

Perfil de infraestructura

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

CPU4 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO30 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

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

Despliegue manual

Despliegue recomendado: Linux con Docker. Ejecutar scripts/setup.sh que configura Caddy, SQLite y contenedores. Alternativa local: Node 22 + ffmpeg + libheif. Asegurar puertos 80/443 abiertos. HTTPS automático vía Let's Encrypt. Backup manual de /data o usar deploy/backup.sh con rsync.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

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

FRAMEWORKS
Node.js
SERVICIOS
PostgreSQLRedisS3/MinIO
BASES DE DATOS
PostgreSQLRedis
PUERTOS
5173
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.