Sitio de landing page de producto
Una receta, destilada del sitio de marketing de Kesami, para una única página estática que parece diseñada en lugar de basada en plantillas y que resiste el escrutinio: contraste verificado, amigable con el teclado, honesta sobre el producto, rápida.
El resultado es una página de Next.js compuesta por secciones renderizadas en el servidor. La interactividad se limita a unas pocas pequeñas "islas" de cliente que modifican atributos DOM o variables CSS en lugar de re-renderizar. No hay biblioteca de UI, ni Tailwind, ni biblioteca de animación.
Qué se incluye
| Ruta | Uso |
|---|---|
assets/scaffold/ | Un sitio completo y construible (verificado con typecheck y next build). Cópialo, no lo reescribas. Contenido de relleno, sistema de diseño funcional. |
assets/optional-sections/ | Tres secciones adicionales del sitio original (una comparación antes/después, un árbol de archivos de límite de datos, un muro de scripts) como ejemplos prácticos. No están conectadas. |
scripts/accent.mjs | Deriva los tonos de acento seguros para contraste de cualquier color de marca. |
scripts/capture.cjs | Captura pantallas del sitio en ejecución en tamaños de escritorio y móvil, avanzando a través del scroll, mediante una ventana de Electron fuera de pantalla. |
references/design-system.md | Tokens, temas, tipografía, espaciado, la lógica de contraste de acento y por qué existe cada uno. Léelo antes de cambiar colores o tipografía. |
references/section-patterns.md | Cada sección: para qué sirve, cómo se construye, el truco que la hace económica. Léelo antes de añadir o modificar una sección. |
references/motion-and-a11y.md | Presupuesto de movimiento, movimiento reducido, sin JS, objetivos táctiles, trampas de hidratación. Léelo antes de añadir cualquier animación o código de cliente. |
references/copy-and-facts.md | Voz, la regla de un solo escenario y cómo mantener las afirmaciones verdaderas. Léelo antes de redactar el copy. |
references/verify.md | La lista de verificación y comandos para ejecutar antes de dar el sitio por terminado. |
Flujo de trabajo
1. Recopilar entradas (mira antes de preguntar)
Primero lee el README del producto, el manifiesto del paquete, el código de precios/planes y el flujo de trabajo de lanzamiento; la mayoría de las respuestas están ahí. Pregunta al usuario solo por lo que no se puede encontrar. Necesitas:
- Nombre del producto, promesa en una frase, para quién es y la única cosa que lo diferencia.
- Plataformas, precios y límites de planes, cada uno con el archivo que es la fuente de verdad.
- Un color de marca (cualquier hex), o permiso para elegir uno. Elige un solo color y úsalo como el único color de señal.
- Si existe una fuente de visualización con licencia. Si no, el sustituto de licencia abierta del scaffold (Instrument Serif) está bien.
- Qué secciones aplicar. Conjunto por defecto: Hero, ticker, Cómo funciona, Pregunta/demo, Precios, FAQ, Cierre, Pie de página. Añade Privacidad, Idiomas o una comparación antes/después cuando el producto tenga una historia que lo requiera.
- Dónde vive el sitio. Por defecto: una carpeta
website/en el repositorio del producto, un paquete independiente fuera de cualquier espacio de trabajo npm para que las instalaciones de la app y el archivo de bloqueo no se toquen.
2. Scaffold
cp -R ~/.claude/skills/product-landing-site/assets/scaffold <target>/website
cd <target>/website && npm install && npx tsc --noEmit && npx next build
Ejecuta la compilación una vez antes de editar para asegurarte de que la línea base esté en verde. Mona Sans se obtiene de Google Fonts en tiempo de compilación y luego se sirve desde el propio sitio, por lo que la primera compilación necesita red.
3. Marca
node ~/.claude/skills/product-landing-site/scripts/accent.mjs <brand-hex>imprime--accent,--accent-display, el tinte plano y si la etiqueta del botón debe ser tinta o blanco. Ponlos enapp/globals.css(--brand,--brand-hover,--brand-tint,--accent,--accent-display) y reemplaza los valores fijos#ff5e00/#e25300enapp/icon.svgyapp/opengraph-image.tsx.- Redibuja la marca en
components/Logo.tsxyLogo.module.css(el marcador de posición son cuatro barras de voz). Mantenlo como divs o SVG en línea, nunca un ráster. - Establece
SITEenlib/site.ts(nombre, slug, marca, titular, lead, CTA, nota). Elslugtambién asigna un espacio de nombres a la preferencia de moneda en localStorage.
Por qué el script en lugar de hacerlo a ojo: un color de marca saturado casi nunca alcanza 4.5:1 como texto sobre un fondo claro, por lo que la página necesita el color de marca para rellenos y un tono más oscuro para el texto. Adivinar el tono hermano es cómo los sitios terminan con contraste fallido.
4. Hechos antes del copy
Llena lib/site.ts (planes, plataforma, enlaces, FAQ) a partir de los propios archivos fuente del producto, y registra la fuente de cada hecho en el README.md del sitio bajo "De dónde vienen los hechos". Mantén la procedencia en el README en lugar de en comentarios de código, para que el scaffold se mantenga libre de comentarios. Si el repositorio objetivo o el usuario solicita comentarios explicativos, sigue eso en su lugar.
Luego lee references/copy-and-facts.md y redacta el copy.
5. Un escenario, compartido en todas partes
lib/demo.ts contiene un único escenario ficticio del cual se alimentan la maqueta del héroe, la historia del producto y la demostración interactiva. Reemplázalo con un escenario del propio dominio del producto (tickets de soporte, un pull request, un calendario, una hoja de cálculo, una reunión). Debido a que cada sección lee los mismos datos, la página nunca se contradice, y la demo puede mostrar honestamente el contrato real del producto (por ejemplo, cada afirmación cita su fuente).
6. Secciones
Comienza con las nueve del scaffold. Para cada sección decide: ¿qué única idea lleva, y cuál es la única imagen que la prueba en lugar de describirla? Lee references/section-patterns.md. Sigue la gramática de la sección:
- chip de etiqueta (
.label, condata-scramble), luego unh2.display.h2con las últimas palabras en.em, luego un.leadopcional - las secciones alternan
data-theme="light"/"paper"para que cada una comience en un borde de color, no en una línea de regla - un botón relleno por viewport; todo lo demás es un enlace de texto con el subrayado de la marca
- las maquetas de producto usan
data-theme="dark"y tamaños en px, porque representan capturas de pantalla de la app (oscura). Si la app es clara, haz las maquetas claras.
7. Verificar
Sigue references/verify.md. En resumen: typecheck, compilación, capturas de pantalla a 1440 y 390 con scripts/capture.cjs, léelas, avanza por el scroll para confirmar que las revelaciones se activan, verifica el modo de movimiento reducido y sin JS, vuelve a ejecutar accent.mjs --check para cualquier nuevo color de texto. Informa cualquier cosa no verificada en lugar de insinuar que lo fue.
No negociables, y por qué
- Componentes de servidor por defecto; islas de cliente solo para comportamiento. La página es HTML estático que funciona sin JS y cuesta casi nada de hidratar. Las islas escriben atributos
data-*o variables CSS y dejan que CSS haga el trabajo visual. - Solo tokens semánticos en los componentes. Los componentes leen
--bg,--fg,--accent; eldata-themede una sección los intercambia. Así es como un componente puede estar en Canvas, blanco, el tinte o una maqueta oscura sin ediciones. - Tamaños de texto en rem, maquetas en px. El tamaño de texto del navegador del lector debe aplicarse a la página; las maquetas son representantes de capturas de pantalla.
- El texto atenuado retrocede por color, nunca por opacidad. La opacidad reduce silenciosamente el contraste por debajo de 4.5:1.
- El copy nunca supera al producto. Sin plataformas no lanzadas, sin dirección de soporte que no exista, sin "nada sale de tu dispositivo" si el audio se transmite a un servidor. Una página de marketing que promete de más es un error.
- No hay control de pausa de animación incorporado. El movimiento en bucle se detiene para
prefers-reduced-motion. La revisión de diseño de Kesami declinó deliberadamente un control de pausa, por lo que el scaffold no tiene ninguno; ofrece uno si el usuario lo desea.
Extender más allá del scaffold
Inventa nuevas secciones con los mismos primitivos en lugar de importar una biblioteca: propiedades personalizadas de CSS para estado, un IntersectionObserver por comportamiento, details/summary para divulgación, position: sticky para scrollytelling, @property para animar variables. Si te encuentras recurriendo a framer-motion o un paquete de carrusel, relee references/motion-and-a11y.md primero; la respuesta es casi siempre una variable CSS y un atributo.