FrrCard
Aplicación self-hosted que genera tarjetas de presentación digitales estáticas desde archivos JSON. Usa Next.js y Node.js en un único contenedor Docker para crear páginas HTML, códigos QR SVG y archivos VCF descargables sin bases de datos ni servicios externos.
Ficha actualizada 25 sept 2026, 4:19 · upstream 24 sept 2026, 23:51 · release v1.1.2
Qué es FrrCard
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
FrrCard transforma datos almacenados en archivos JSON dentro de un volumen montado (data/) en páginas web estáticas optimizadas. Cada tarjeta se genera con un único archivo HTML por persona, incluyendo enlaces directos a redes sociales, correos electrónicos y teléfonos, además de generar automáticamente códigos QR que apuntan al dominio configurado.
La arquitectura es minimalista: un único servicio con Next.js como renderer y Node.js para el servidor estático. No hay dependencias de bases de datos ni servicios externos críticos. Los archivos generados se almacenan en un volumen interno (dist/) que puede montarse externamente si se desea persistencia fuera del contenedor.
El sistema soporta múltiples tarjetas simultáneas dentro del mismo contenedor, permitiendo servir equipos o familias desde una sola instancia. Soporta tanto despliegue desde Docker Hub como construcción local desde checkout del repositorio.
- Tarjetas digitales para profesionales independientes sin necesidad de suscripciones mensuales
- Solución self-hosted para equipos pequeños que necesitan múltiples tarjetas desde un solo servidor
- Alternativa a servicios comerciales para proteger datos de contacto en infraestructura propia
- Generación de códigos QR para eventos presenciales con enlaces directos a perfiles digitales
- Arquitectura sin base de datos que garantiza privacidad total de los datos de contacto
- Generación automática de archivos VCF compatibles con todos los sistemas operativos móviles
- Rendimiento óptimo con archivos HTML estáticos sin llamadas a APIs externas
- Soporte nativo para modo oscuro/claro siguiendo preferencias del sistema del visitante
- Requiere reinicio del contenedor tras cada modificación de archivos JSON en el volumen montado
- No incluye panel de administración web, gestionando todos los datos mediante edición manual de archivos
- Dependencia de Docker Compose para despliegue inicial (no soporta instalación sin contenedores)
- Los archivos generados persisten solo dentro del contenedor por defecto sin volumen externo
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.
Requiere Docker con plugin compose instalado. Para producción, usar imagen oficial ghcr.io/frrcode/frrcard:latest o versiones específicas. Montar volúmenes data/ y public/ en el contenedor. Para dominios múltiples, configurar reverse proxy (Caddy/Nginx) con subdominios por tarjeta. El puerto interno es 8080, mapeable a cualquier puerto externo. No persiste datos fuera del contenedor sin volúmenes adicionales.
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.