Lanzamiento de la página de aterrizaje
Prepara una página de aterrizaje construida para su lanzamiento: alojamiento, análisis de página, un evento de conversión para su única llamada a la acción, un formulario de leads funcional, una prueba A/B opcional y una lista de verificación de lanzamiento. La habilidad prepara y prueba todo localmente. Nunca despliega ni cambia DNS sin la aprobación del usuario.
Los comandos, claves de configuración y límites de Cloudflare cambian. Los aquí incluidos se verificaron con la documentación de Cloudflare el 2026-10-04 y el código del Worker se ejecutó con Wrangler 4.147.0. Antes de confiar en un comando o límite, confírmalo en la documentación actual de Cloudflare y confía en la documentación donde difiera de esta habilidad.
Entradas
Lee primero los archivos y pregunta al usuario solo por lo que deje abierto, en un solo mensaje.
| Entrada | Dónde | Si falta |
|---|---|---|
La página construida, y /thanks/ y /form-error/ cuando el formulario se envía al Worker de esta habilidad | La salida de la construcción (dist/, public/, una carpeta de exportación), escrita por landing-skills:landing-build | Ejecuta la construcción. Si aún no hay página, detente y di que la página viene primero (landing-skills:landing-build). |
La acción de conversión: formulario o página externa, los campos del formulario, el estado del endpoint (ninguno aún o una URL), o la URL externa | Conversion action en landing/brief.md | Léela de la página: la action del formulario y el name de cada campo, o el enlace principal. Confirma con el usuario en una pregunta. |
Cada name de campo que envía el formulario y el estado del endpoint | La transferencia de la construcción; de lo contrario, los atributos name del formulario construido | Léelos del formulario construido. |
| Dominio | Domain en landing/brief.md | Pregunta. Si permanece desconocido, usa la dirección workers.dev y marca los elementos del dominio como pendientes. |
Rutas de contacto, para /form-error/ y el pie de página | Contact routes en landing/brief.md | Pregunta. Hasta que se responda, un [PLACEHOLDER: ...] visible, elemento pendiente. |
| Mensajes del formulario, de agradecimiento y de error | landing/copy.md | Escribe mensajes cortos y simples en el idioma de la página y enuméralos para que el usuario los apruebe. |
| Elección de alojamiento | el usuario | Recomienda Cloudflare (abajo). Si se niega, ve a No usar Cloudflare. |
| Aviso de privacidad | el pie de página de la página y el formulario | Pregunta al usuario por él; hasta entonces un [PLACEHOLDER: ...] visible, elemento pendiente. Nunca inventes uno. |
Lo que escribe esta habilidad: configuración de alojamiento, el Worker del formulario cuando sea necesario, el fragmento de análisis y el evento de conversión, y landing/launch.md con la lista de verificación. No escribe copia ni reescribe las páginas de la construcción.
Identifica el stack (HTML plano, Astro, Vite con React, Next.js) y su carpeta de salida antes de escribir cualquier configuración.
Recomendación
Sugiere Cloudflare para los tres trabajos y explica por qué en estos términos:
- Alojamiento: Los activos estáticos de Workers sirven la página; las solicitudes estáticas son gratuitas e ilimitadas en el plan Free, y Cloudflare recomienda Workers sobre Pages para nuevos proyectos. El mismo proyecto puede ejecutar un Worker pequeño para el formulario, por lo que la página no necesita otro backend.
- Análisis: Cloudflare Web Analytics cuenta el tráfico y las Core Web Vitals sin cookies ni fingerprinting. No tiene eventos personalizados, por lo que la conversión se cuenta mediante el Worker en Workers Analytics Engine, en la misma cuenta, gratis en el plan Free.
- Pruebas A/B: el mismo Worker puede asignar variantes en el borde antes de que se sirva la página. Sin script de prueba del lado del cliente, sin parpadeo, y funciona con JavaScript desactivado.
Indica también los costos: un dominio personalizado necesita el DNS del dominio en Cloudflare, y cada solicitud que ejecuta el Worker cuenta contra 100,000 por día en el plan Free.
Proceso
-
Lee las entradas. De
landing/brief.md, toma la acción de conversión (formulario o página externa, sus campos, el estado del endpoint), el dominio y las rutas de contacto. De la página construida, observa cada formulario con suactiony nombres de campo, y cada enlace de llamada a la acción. Pregunta solo lo que aún falta.Luego elige el caso, que decide qué agregas:
- Formulario, endpoint
ninguno aún(envía a/api/lead, que nada sirve aún): el Worker del formulario, pasos 4 y 5. - Formulario, endpoint existe: sin Worker de formulario ni Turnstile. Verifica que el formulario envíe a ese endpoint y que las páginas de resultado coincidan con lo que devuelve, y registra que la validación y la protección contra spam son trabajo de ese endpoint.
- Página externa (checkout, reserva, tienda de aplicaciones): sin formulario que manejar. El enlace va a la URL real y el clic se cuenta con la baliza en el paso 5; los elementos del formulario en la lista de verificación son
n/a.
- Formulario, endpoint
-
Arregla primero los callejones sin salida. Busca en la construcción un formulario cuya acción no lleve a ninguna parte o cuyo envío se cancele, un controlador de envío que solo muestre un mensaje de agradecimiento, enlaces a un
#vacío, y botones que enlacen a la sección en la que están. Cada uno de estos significa que la conversión no existe. Un formulario obtiene el endpoint del Worker en el paso 4; un enlace obtiene la URL real del usuario, o un[PLACEHOLDER: ...]visible y un elemento pendiente en la lista de verificación. -
Configuración de alojamiento. Escribe
wrangler.jsoncpara el stack, instala Wrangler en el proyecto, agrega404.htmlsi falta, y agrega_headerso_redirectssolo cuando haya algo que poner en ellos. Leereferences/hosting.md. -
Endpoint del formulario (formulario, endpoint
ninguno aún). Agrega el Worker del formulario: validación del servidor, verificación de Turnstile con Siteverify, almacenamiento D1, y las rutas de respuesta con JavaScript y sin JavaScript. Agrega el widget de Turnstile al formulario de la construcción; mantén el marcado y el script de mejora de la construcción. Verifica que/thanks/y/form-error/existan y que/form-error/ofrezca una ruta de contacto del brief. Crea una página de resultado solo si falta, y nunca sobrescribas una:landing-skills:landing-buildlas posee. Leereferences/forms.md.Cada campo se maneja. Enumera cada
namede campo que el formulario envía y asigna a cada uno una entrada en la tablaFIELDSdel Worker (obligatorio o no, un límite de longitud, una verificación de formato cuando sea significativa, de lo contrario texto con un límite), una columna en la tablaleads, y unMAX_BYTESque los contenga a todos. Nada se almacena sin validar. Un campo enviado que el Worker no maneje falla la lista de verificación; el Worker rechaza tal envío conunknown_field, lo que hace visible la brecha en las pruebas, pero el envío del visitante se pierde hasta que se agregue el campo. -
Análisis y evento de conversión. Agrega el fragmento de Web Analytics a cada página y registra la conversión en Analytics Engine: en el Worker del formulario cuando lo agregaste, mediante baliza para un enlace. Con un endpoint existente, la conversión se cuenta a partir de los registros de ese endpoint, y la baliza es una opción. Lee
references/analytics.md. -
Prueba A/B, solo si se solicita. Acuerda el único cambio, la línea base, la diferencia más pequeña que valga la pena actuar y el tamaño de la muestra antes de escribir cualquier código. Luego agrega el archivo de variante y el Worker A/B. Lee
references/ab-testing.md. -
Prueba localmente. Ejecuta
npx wrangler devcon claves de prueba de Turnstile en.dev.varsy ejercita cada ruta con curl y un navegador: envío válido con todos los campos, correo electrónico no válido, cada campo por encima de su límite, Turnstile fallido, JavaScript desactivado, y para una prueba: asignación, la cookie persistente en una segunda solicitud, el endpoint de conversión. Luego ejecutanpx wrangler deploy --dry-runy verifica el recuento y tamaño de los activos. Las ejecuciones locales no necesitan cuenta. Arregla todo lo que falle antes de continuar. -
Detente para la aprobación. Desplegar, crear una vista previa, agregar un dominio personalizado o ruta, crear una base de datos D1, ejecutar
d1 execute --remote, establecer un secreto, crear el widget de Turnstile y agregar el sitio a Web Analytics cambian todos la cuenta de Cloudflare del usuario, y un despliegue o cambio de DNS es visible para el público de inmediato. El usuario puede estar en medio de una revisión, el dominio puede aún servir un sitio antiguo, y un cambio incorrecto de DNS puede dejar un sitio en vivo caído. Por lo tanto, enumera cada paso hacia el exterior con su comando exacto y lo que cambiará, y ejecuta cada uno solo cuando el usuario diga que sí en ese momento. Un sí a un paso no es un sí al siguiente. Si el usuario prefiere ejecutarlos, entrega los comandos en orden. -
Después del despliegue (con el usuario). Envía el formulario en vivo una vez, confirma la fila en D1 y la conversión en Analytics Engine, confirma que Web Analytics muestra la visita, y verifica los elementos de la lista de verificación que solo se pueden verificar en vivo.
-
Escribe
landing/launch.md. Registra la configuración de alojamiento, la acción de conversión y cómo se cuenta, el plan A/B si lo hay, los comandos para los pasos hacia el exterior, y la lista de verificación de lanzamiento con cada elemento marcadodone,pending,failon/ay la razón para cada uno que no seadone. Muestra la lista de verificación al usuario.
Lista de verificación de lanzamiento
Copia esto en landing/launch.md y marca cada línea done, pending (reason), fail (reason) o n/a (reason). Un elemento que no pudiste verificar está pendiente, nunca hecho. Los elementos del formulario son n/a cuando la llamada a la acción es una página externa.
Conversión
- La llamada a la acción lleva a una acción funcional: el formulario envía a
/api/lead(o al endpoint existente del usuario), o el enlace va a la URL real del usuario. Sinhref="#", sin auto-ancla, sin éxito falso. - Cada
namede campo que el formulario envía tiene una entradaFIELDScon un límite de longitud y una columnaleads. Cualquier campo no manejado es un fallo, nunca un pase. - Con un endpoint existente: responde JSON con
okparaAccept: application/jsony redirige a/thanks/o/form-error/de lo contrario, o las páginas de resultado coinciden con lo que devuelve; la validación y la protección contra spam se registran como su trabajo. - Cuando el formulario envía al Worker de esta habilidad:
/thanks/y/form-error/existen (las páginas propias de la construcción, no sobrescritas), y/form-error/ofrece una ruta de contacto del brief. Con un endpoint existente, las páginas coinciden con lo que devuelve; con un enlace externo,n/a. - Formulario probado localmente: envío válido, correo electrónico no válido, Turnstile fallido, JavaScript desactivado (aterriza en
/form-error/). - El botón se deshabilita mientras envía; el éxito y el error se anuncian en un elemento
role="status". - El honeypot está oculto a la vista y a la tecnología de asistencia.
- Formulario en vivo probado una vez después del despliegue; la fila está en D1.
- Sin promesa de un correo de confirmación a menos que el usuario tenga una forma de enviarlo.
Medición
- Fragmento de Web Analytics en vivo con el token real en cada página (pendiente: el fragmento está en un comentario HTML hasta que exista el token), incluyendo
/thanks/,/form-error/y404.html. - La conversión se escribe en Analytics Engine, y una conversión de prueba en vivo aparece en la consulta SQL.
- Web Analytics muestra la visita en vivo.
- Durante una prueba A/B: los recuentos de visitantes y conversiones por variante aparecen, y el tamaño de la muestra y la regla de finalización se escriben en
landing/launch.md.
Alojamiento
-
npx wrangler deploy --dry-runpasa; archivos de activos bajo 20,000, ninguno sobre 25 MiB. - El dominio personalizado sirve la página sobre HTTPS;
workers_devconfigurado como el usuario desea. - Redirecciones en
_redirectsprobadas en vivo. - Las rutas desconocidas devuelven el
404.htmlpersonalizado con estado 404.
Página
- Etiquetas de título, meta descripción, URL canónica y Open Graph y tarjeta social presentes; la imagen de la tarjeta se carga desde la URL en vivo y la vista previa se ve correcta cuando el enlace se pega en un depurador de compartir o una aplicación de chat.
-
robots.txty un sitemap que enumera la URL en vivo; las páginas de resultado y vistas previas sonnoindex. - Favicon presente.
- Aviso de privacidad enlazado junto al formulario y en el pie de página, nombrando Turnstile (un script de Cloudflare) y cada campo que almacena el formulario, por nombre; detalles de contacto (correo electrónico, teléfono o el canal de mensajería que la audiencia realmente usa) y quién dirige el sitio.
- Cualquier declaración de "sin cookies" sigue siendo cierta (no lo es mientras una prueba A/B establece su cookie).
- Cada
[PLACEHOLDER: ...]resuelto: fotos y capturas de pantalla reales en su lugar, precios y fechas confirmados.
Cuentas y secretos
- Widget de Turnstile creado para el nombre de host de producción; la sitekey real está en el HTML.
-
TURNSTILE_SECRETconfigurado conwrangler secret put(nunca comprometido);.dev.vars*y.wrangler/en.gitignore. - Cada paso hacia el exterior fue confirmado por el usuario antes de ejecutarse.
No usar Cloudflare
La construcción es salida estática simple: HTML, CSS, JavaScript y activos en una carpeta. Cualquier host estático o el propio servidor del usuario puede servirla tal cual.
Si el usuario no quiere Cloudflare, no agregues archivos de Cloudflare: sin wrangler.jsonc, sin Worker, sin Turnstile, sin fragmento de Web Analytics, sin .dev.vars. Elimina cualquier que hayas agregado antes en la sesión. Luego ve directamente a la lista de verificación de lanzamiento y trabaja a través de los elementos que no nombren un producto de Cloudflare. Para el formulario y la conversión, los elementos de la lista de verificación aún aplican: el formulario necesita un endpoint real en el servidor o servicio del usuario, validado en el servidor, y la conversión necesita una forma de ser contada. Nombra lo que falta, márcalo como pendiente y deja la elección de la herramienta al usuario. Esta habilidad no da recetas para otros hosts.
Autoverificación
Antes de informar:
- Nada se desplegó, previsualizó, enrutó o creó en la cuenta del usuario sin un sí para ese paso.
- Cada cambio de configuración pasó
npx wrangler deploy --dry-run, y las verificaciones locales con curl dieron los códigos de estado esperados. - Ningún archivo afirma que Web Analytics cuenta clics o conversiones.
- Ningún secreto, token o id de cuenta se escribe en un archivo comprometido.
landing/launch.mdexiste, y cada línea de la lista de verificación está marcada, con una razón para cada una que no seadone, y ningún campo de formulario enviado queda sin manejar.
Referencias
references/hosting.md: configuración por stack, comandos, la ejecución en seco, dominio personalizado,_redirectsy_headers, almacenamiento en caché, 404, vistas previas. Leer en el paso 3.references/forms.md: el marcado del formulario, el Worker del formulario probado, pruebas locales con claves de prueba de Turnstile, configuración de producción. Leer en el paso 4 cuando la página tenga un formulario.references/analytics.md: configuración de Web Analytics, el evento de conversión en Analytics Engine, la consulta, declaraciones de privacidad, qué verificar después del despliegue. Leer en el paso 5.references/ab-testing.md: el costo en el plan Free, el probado
…
[truncado para traducción]