Marca de lanzamiento
Cada video de lanzamiento lee su apariencia de brand/brand.json. Esta habilidad crea ese archivo a partir del sitio web del lector, lo verifica y lo entrega a launch-film. Ejecútalo una vez por marca, de nuevo cuando cambie la apariencia del sitio.
1. Extraer
npm install # una vez: puppeteer y su Chrome
node tools/brand-from-url.mjs https://tu-sitio.com --out brand
Abre la página a 1920x1080, descarta los banners de cookies, se desplaza una vez para que se cargue el contenido lazy y escribe:
| Archivo | Qué contiene |
|---|---|
brand.json | Los roles que usa el video. El único archivo que lee el video. |
evidence.json | Cómo se decidió cada rol: estilos calculados, variables CSS de color, histogramas de píxeles, colores de botones y enlaces, familias tipográficas, cada candidato a logotipo con su puntuación y razón. |
logo.svg o logo.png | El logotipo para fondos claros. logo-on-dark.* para fondos oscuros, mark.svg cuando se puede separar una marca de icono. |
fonts/ | Los archivos de tipografía de visualización y cuerpo que la página realmente cargó (las fuentes de Google Fonts se obtienen de la API css2 cuando la página no las sirve). |
screens/hero.png, screens/full.png | El primer viewport y la página completa (limitada a 6000 px). |
images/ | Las imágenes de contenido más grandes, generalmente fotos de productos. |
preview.png | Una hoja: logotipo sobre fondo claro y sobre oscuro, cada rol de color, la tipografía de visualización con el resaltado, una tarjeta hero oscura, el botón de acento. |
Banderas: --no-fonts omite los archivos de tipografía, --max-images 0 omite las imágenes. También funciona con una página local (node tools/brand-from-url.mjs ./site/index.html). Después de editar brand.json a mano, vuelve a renderizar la hoja con node tools/brand-from-url.mjs --preview --out brand.
2. Revisar (nunca saltar)
Lee preview.png y screens/hero.png lado a lado. Los roles son heurísticos; la hoja muestra en 10 segundos si se eligieron correctamente. Verifica, en este orden:
- Logotipo sobre fondo claro y sobre fondo oscuro. Ambos deben leerse. Un logotipo que desaparece sobre fondo oscuro necesita una versión clara: pídele al lector su archivo, o edita los colores dentro de
logo-on-dark.svg. - Acento. Debe ser el color que la gente asocia con la marca, generalmente el botón principal.
evidence.jsonlistaaccent_candidatescon sus votos. Intercambia el hex correcto cuando eligió un color de ilustración hero o un color de estado. - Fondo y tinta. Las escenas de declaración se colocan sobre
groundcon tipoink. Deben coincidir con la sensación del sitio (blanco roto cálido, blanco puro, un papel teñido). - Oscuro. Las tarjetas hero usan
dark. Debe parecerse a la sección oscura propia de la marca, no a un negro casi aleatorio. Si el sitio no tiene ninguna, la herramienta oscurece el acento; verifica que se vea intencionado. - Tipografías. La tipografía de visualización debe renderizarse en las palabras hero de la hoja.
evidence.jsonbajofontsmuestra qué archivos se encontraron. - Nombre y eslogan. El eslogan se coloca debajo del nombre en el bloque: de 2 a 8 palabras, las propias palabras del sitio.
Corrige los valores incorrectos directamente en brand.json, vuelve a renderizar la previsualización, muéstrala al lector, y solo entonces establece "reviewed": true. Registra cualquier cosa que hayas cambiado a mano en una línea en tu respuesta.
Qué hace cada rol en el video
| Rol | Se usa para |
|---|---|
ground | Cada escena de declaración, el suelo del recorrido del producto, el bloque final. |
surface | Tarjetas, chips y ventanas sobre el fondo. |
ink, ink_secondary | Palabras hero y palabras de apoyo sobre fondos claros. |
accent | Con moderación: 1 elemento por escena (una pulsación de botón, el interruptor, el estado completado). Nunca un fondo completo a menos que el briefing pida una tarjeta hero de acento. |
accent_ink | Texto sobre el acento. |
dark, dark_ink | Tarjetas hero de corte duro, los momentos oscuros. |
accent_on_dark | Palabras clave en tarjetas oscuras (el acento aclarado hasta que se lea; dark_ink para marcas monocromáticas). |
highlight | Un marcador suave detrás de 1 o 2 palabras clave por línea, nunca más. |
success, danger | Marcas de verificación, estados completados, la rara palabra de error. |
fonts.display | Palabras hero (peso y tracking del h1 del sitio). |
fonts.body | Líneas de apoyo, chips de UI. |
logo, name, tagline, domain | El golpe de nombre en el corte y el bloque final. |
copy | Palabras para el guion. El video habla el idioma del sitio; launch-story comienza desde copy.h1, copy.subhead, copy.h2 y copy.features. |
images | Fotos de producto candidatas. Las capturas de pantalla o grabaciones reales del producto del lector superan cualquier cosa extraída. |
Fallbacks
- No se encontró logotipo. La herramienta recurre al icono del sitio y lo indica. Pídele al lector un SVG (mejor) o un PNG transparente de al menos 1000 px de ancho; colócalo en
brand/y apuntalogo.filea él. - Sitio en modo oscuro.
modeesdark. El fondo de la página se convierte endark, ygroundeinkse derivan para escenas de declaración claras. Si la marca quiere también escenas de declaración oscuras, intercambiagroundydark(einkydark_ink) a mano. - Marca monocromática. Ningún color saturado ganó un voto, por lo que
accentes el color del botón principal (a menudo negro) yhighlightes un gris claro. Pregunta al lector si tiene un color distintivo; si no, mantenlo monocromático y deja que la tipografía y el movimiento lleven el video. - Tipografía web no descargable. Algunas fundiciones bloquean las descargas directas. Instala la tipografía localmente (el video recurre a las tipografías instaladas por nombre de familia) o elige la tipografía abierta más cercana de Google Fonts y coloca sus archivos en
brand/fonts/. - Licencias de tipografía. Una licencia web no siempre cubre video. Antes de que el video se envíe, confirma que las tipografías de visualización y cuerpo estén licenciadas para uso en video o movimiento, o utiliza una tipografía abierta (OFL).
- El lector tiene una guía de marca. Su guía prevalece. Ingresa sus valores en
brand.jsona mano (mantén las mismas claves), coloca los archivos de logotipo enbrand/, vuelve a renderizar la previsualización y márcala como revisada. - El sitio bloquea navegadores headless. Guarda la página desde un navegador normal (Archivo, Guardar página como, completa) y ejecuta la herramienta en el archivo HTML guardado.
Entrega
launch-film lee brand/brand.json en tiempo de construcción. Un video construido con "reviewed": false es un borrador; díselo cuando lo muestres.