StoryShelf
StoryShelf es una plataforma de visualización y validación de pruebas para Storybook, que permite ejecutar tests visuales en la nube sin necesidad de un servidor local. Funciona como alternativa a Chromatic, con soporte nativo para Storybook y almacenamiento ilimitado.
Ficha actualizada 23 sept 2026, 13:08 · upstream 23 sept 2026, 12:34 · release v0.3.2
Qué es StoryShelf
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
StoryShelf es una herramienta de desarrollo autónoma diseñada para automatizar el proceso de visual testing en proyectos basados en Storybook. Su arquitectura se centra en la separación clara entre capa de lógica (core) y capa de presentación (app), permitiendo un despliegue escalable y flexible.
La plataforma permite ejecutar tests visuales mediante diferentes runners (Playwright, Puppeteer) contra una base de datos local o remota, generando reportes comparativos. Los snapshots se guardan en almacenamiento compatible con S3, lo que facilita la colaboración entre equipos y el cumplimiento de políticas de seguridad corporativa.
StoryShelf ofrece un ecosistema completo de herramientas integradas: gestión de autenticación (OIDC, password), integración con GitLab o GitHub para comentarios de merge gate, y un CLI robusto que simplifica la inicialización y administración del proyecto. La arquitectura modular permite a los desarrolladores elegir su stack tecnológico sin comprometer la consistencia del pipeline.
- Automatizar pruebas visuales en proyectos con Storybook sin necesidad de configurar un servidor local
- Revisar cambios de diseño antes de enviarlos al staging o producción mediante reportes comparativos
- Implementar políticas de seguridad corporativa que requieran aprobación visual antes del despliegue
- Reducir el tiempo de feedback en equipos distribuidos, ya que los tests se ejecutan desde cualquier ubicación
- Integración con pipelines CI/CD para automatizar la validación de cambios en desarrollo
- Colaboración entre desarrolladores y QA mediante comentarios visuales en commits o PRs
- Soporte nativo de Storybook, permitiendo capturar snapshots directamente desde el framework sin necesidad de adaptar los componentes
- Almacenamiento ilimitado con soporte para S3-compatible (MinIO), lo que permite escalar horizontalmente según la demanda
- Arquitectura desacoplada entre core y app, facilitando actualizaciones de capa sin afectar a otras dependencias
- Soporte multi-runner mediante Playwright y Puppeteer, permitiendo pruebas visuales en diferentes navegadores o entornos
- Integración con GitLab y GitHub para automatizar comentarios de merge gate y feedback visual en PRs
- API RESTful completa que permite consumir los snapshots como datos JSON desde cualquier cliente externo
- Los tests visuales requieren una conexión a internet estable durante la ejecución, lo que puede ser un problema en entornos de despliegue offline
- La generación de reportes comparativos puede generar archivos grandes si se ejecutan muchos snapshots sin optimización
- El almacenamiento local (filesystem) no es escalable y puede consumir recursos significativos en servidores con pocos núcleos
- La integración con GitLab requiere configuración adicional, ya que Storybook no soporta nativamente los comentarios de merge gate
- No existe un runner por defecto para pruebas visuales; se debe elegir entre Playwright o Puppeteer según el caso de uso
- El almacenamiento en S3 puede requerir configuración adicional (credentials, bucket policies) dependiendo del proveedor
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.
StoryShelf es compatible con Docker y Fly.io. Para un entorno local, se recomienda usar la opción 'fly-app' que incluye todos los adapters necesarios para ejecutar el proyecto desde una máquina local. En producción, se recomienda desplegar en AWS o Azure usando Docker Compose, ya que permite escalar horizontalmente mediante contenedores. Se debe configurar un bucket S3 compatible con S3 (como MinIO) y gestionar las credenciales de acceso mediante IAM roles o archivos de configuración seguros. La documentación del proyecto incluye una guía completa de despliegue en Fly.io para desarrolladores que prefieran un enfoque más sencillo.
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.