@vinnyum/carousel-generator

Una herramienta para generar PDFs de carruseles en alta resolución (1080x1350) listos para redes sociales (LinkedIn, Instagram) a partir de plantillas HTML/CSS y datos dinámicos en formato JSON.

🚀 Instalación y Uso

Puedes ejecutarla directamente usando npx:

npx @vinnyum/carousel-generator <command> [options]

🛠 Comandos Disponibles

1. init

Crea una plantilla base personalizable en el directorio ./carousel-template/ de tu proyecto. Esta plantilla incluye archivos HTML, estilos CSS y scripts JS listos para que agregues tu marca y diseño.

npx @vinnyum/carousel-generator init

2. build

Utiliza Puppeteer para levantar la plantilla, inyectar los datos de tu archivo JSON y exportar un PDF optimizado de varias páginas.

npx @vinnyum/carousel-generator build --data <ruta_al_archivo_json> [opciones]

Opciones de build:

• -d, --data <file>: (Requerido) Ruta al archivo JSON que contiene la información de las diapositivas.
• -o, --out <file>: Ruta y nombre del PDF generado (por defecto: carousel_<timestamp>.pdf).
• -t, --template <dir>: Directorio con la plantilla personalizada. Si se omite, buscará ./carousel-template/ y, en su defecto, usará la plantilla interna del paquete.

📋 Estructura de Datos (JSON)

El archivo de datos JSON debe contener un arreglo de diapositivas estructurado de la siguiente forma:

{
  "title": "Mi Carrusel",
  "slides": [
    {
      "type": "cover",
      "title": "Título del Carrusel",
      "subtitle": "Un subtítulo descriptivo",
      "author": "@tu_usuario"
    },
    {
      "type": "content",
      "title": "Paso 1: Concepto",
      "text": "Aquí va el contenido explicativo de la primera diapositiva."
    },
    {
      "type": "cta",
      "title": "¿Te gustó?",
      "text": "Sígueme para ver más contenido sobre desarrollo."
    }
  ]
}

📝 Licencia

ISC