Communitygithub.com

Landing Launch — hospedagem Cloudflare, conversão e formulário

Prepara uma landing pronta para o lançamento: hospedagem estática em Workers, Web Analytics sem cookies, evento de conversão para o único CTA, Worker de formulário de leads funcionando, teste A/B opcional e checklist em landing/launch.md. Tudo é testado localmente e nada é publicado nem o DNS alterado sem o aval do usuário.

O que é Landing Launch — hospedagem Cloudflare, conversão e formulário?

Receita Landing Pages, passo 3 (publicar): landing-launch, de Im-Fran/landing-skills. Lê o build e landing/brief.md, identifica a stack (HTML puro, Astro, Vite/React, Next.js) e escreve a configuração de hospedagem, o Worker do formulário, o snippet de analytics e um contador de conversões no Workers Analytics Engine. Os comandos Cloudflare foram conferidos na documentação em 2026-10-04 e rodados com Wrangler 4.147.0; o skill pede nova checagem, inclui um caminho sem Cloudflare e mantém aviso de privacidade e contatos como placeholders visíveis até você fornecê-los.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-launch

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Lançamento de página de destino

Prepare uma página de destino para lançamento: hospedagem, análise de página, um evento de conversão para sua única chamada para ação, um formulário de lead funcional, um teste A/B opcional e uma lista de verificação de lançamento. A habilidade prepara e testa tudo localmente. Ela nunca implanta ou altera DNS sem a autorização do usuário.

Comandos do Cloudflare, chaves de configuração e limites mudam. Os fornecidos aqui foram verificados com a documentação do Cloudflare em 2026-10-04 e o código do Worker foi executado com Wrangler 4.147.0. Antes de confiar em um comando ou limite, confirme-o na documentação atual do Cloudflare e confie na documentação onde ela discorda desta habilidade.

Entradas

Leia os arquivos primeiro e pergunte ao usuário apenas o que ele deixar em aberto, em uma única mensagem.

EntradaOndeSe ausente
A página criada, e /thanks/ e /form-error/ quando o formulário envia para o Worker desta habilidadea saída da build (dist/, public/, uma pasta de exportação), escrita por landing-skills:landing-buildExecute a build. Se ainda não houver página, pare e diga que a página vem primeiro (landing-skills:landing-build).
A ação de conversão: formulário ou página externa, os campos do formulário, o status do endpoint (nenhum ainda ou uma URL), ou a URL externaConversion action em landing/brief.mdLeia da página: o action do formulário e o name de cada campo, ou o link principal. Confirme com o usuário em uma pergunta.
Cada name de campo que o formulário envia, e o status do endpointa entrega da build; caso contrário, os atributos name do formulário criadoLeia-os do formulário criado.
DomínioDomain em landing/brief.mdPergunte. Se permanecer unknown, use o endereço workers.dev e marque os itens de domínio como pendentes.
Rotas de contato, para /form-error/ e o rodapéContact routes em landing/brief.mdPergunte. Até que seja respondido, um [PLACEHOLDER: ...] visível, item pendente.
Mensagens do formulário, agradecimento e errolanding/copy.mdEscreva mensagens curtas e simples no idioma da página e liste-as para o usuário aprovar.
Escolha de hospedagemo usuárioRecomende Cloudflare (abaixo). Se recusar, vá para Não usando Cloudflare.
Aviso de privacidadeo rodapé da página e o formulárioPeça ao usuário; até lá, um [PLACEHOLDER: ...] visível, item pendente. Nunca invente um.

O que esta habilidade escreve: configuração de hospedagem, o Worker do formulário quando necessário, o snippet de análise e evento de conversão, e landing/launch.md com a lista de verificação. Ela não escreve cópia nem reescreve as páginas da build.

Identifique a stack (HTML simples, Astro, Vite com React, Next.js) e sua pasta de saída antes de escrever qualquer configuração.

Recomendação

Sugira Cloudflare para todas as três tarefas e explique por que nestes termos:

  • Hospedagem: Workers static assets servem a página; requisições estáticas são gratuitas e ilimitadas no plano Free, e o Cloudflare recomenda Workers em vez de Pages para novos projetos. O mesmo projeto pode executar um Worker pequeno para o formulário, então a página não precisa de outro backend.
  • Análise: Cloudflare Web Analytics conta tráfego e Core Web Vitals sem cookies ou fingerprinting. Não tem eventos personalizados, então a conversão é contada pelo Worker no Workers Analytics Engine, na mesma conta, gratuito no plano Free.
  • Teste A/B: o mesmo Worker pode atribuir variantes na borda antes da página ser servida. Nenhum script de teste no lado do cliente, sem flicker, e funciona com JavaScript desligado.

Informe também os custos: um domínio personalizado precisa do DNS do domínio no Cloudflare, e cada requisição que executa o Worker conta contra 100.000 por dia no plano Free.

Processo

  1. Leia as entradas. De landing/brief.md, pegue a ação de conversão (formulário ou página externa, seus campos, o status do endpoint), o domínio e as rotas de contato. Da página criada, observe cada formulário com seu action e nomes de campo, e cada link de chamada para ação. Pergunte apenas o que ainda está faltando.

    Em seguida, escolha o caso, que decide o que você adiciona:

    • Formulário, endpoint nenhum ainda (ele envia para /api/lead, que nada serve ainda): o Worker do formulário, etapas 4 e 5.
    • Formulário, endpoint existe: nenhum Worker de formulário e nenhum Turnstile. Verifique se o formulário envia para esse endpoint e se as páginas de resultado correspondem ao que ele retorna, e registre que a validação e proteção contra spam são responsabilidade desse endpoint.
    • Página externa (checkout, reserva, app store): nenhum formulário para manipular. O link vai para a URL real e o clique é contado com o beacon na etapa 5; os itens do formulário na lista de verificação são n/a.
  2. Corrija os becos sem saída primeiro. Pesquise na build por um formulário cujo action não leva a lugar nenhum ou cujo submit é cancelado, um manipulador de submit que apenas mostra uma mensagem de agradecimento, links para um # vazio e botões que linkam para a seção em que estão. Cada um desses significa que a conversão não existe. Um formulário recebe o endpoint do Worker na etapa 4; um link recebe a URL real do usuário ou um [PLACEHOLDER: ...] visível e um item pendente na lista de verificação.

  3. Configuração de hospedagem. Escreva wrangler.jsonc para a stack, instale Wrangler no projeto, adicione 404.html se ausente e adicione _headers ou _redirects apenas quando houver algo para colocar neles. Leia references/hosting.md.

  4. Endpoint do formulário (formulário, endpoint nenhum ainda). Adicione o Worker do formulário: validação do servidor, verificação Turnstile com Siteverify, armazenamento D1 e os caminhos de resposta com e sem JavaScript. Adicione o widget Turnstile ao formulário da build; mantenha a marcação e o script de aprimoramento da build. Verifique se /thanks/ e /form-error/ existem e se /form-error/ oferece uma rota de contato do brief. Crie uma página de resultado apenas se estiver faltando e nunca substitua uma existente: landing-skills:landing-build as possui. Leia references/forms.md.

    Cada campo é tratado. Liste cada name de campo que o formulário envia e dê a cada um uma entrada na tabela FIELDS do Worker (obrigatório ou não, um limite de comprimento, uma verificação de formato onde for significativo, caso contrário texto com um limite), uma coluna na tabela leads e um MAX_BYTES que os comporte. Nada é armazenado sem validação. Um campo enviado que o Worker não trata faz a lista de verificação falhar; o Worker recusa tal post com unknown_field, o que torna a lacuna visível no teste, mas o envio do visitante ainda é perdido até que o campo seja adicionado.

  5. Análise e o evento de conversão. Adicione o snippet Web Analytics a todas as páginas e registre a conversão no Analytics Engine: no Worker do formulário quando você adicionou um, ou por beacon para um link. Com um endpoint existente, a conversão é contada a partir dos registros desse endpoint, e o beacon é uma opção. Leia references/analytics.md.

  6. Teste A/B, apenas se solicitado. Combine a única mudança, a linha de base, a menor diferença que vale a pena agir e o tamanho da amostra antes de escrever qualquer código. Em seguida, adicione o arquivo de variante e o Worker A/B. Leia references/ab-testing.md.

  7. Teste localmente. Execute npx wrangler dev com chaves de teste Turnstile em .dev.vars e exercite cada caminho com curl e um navegador: post válido com todos os campos, email inválido, cada campo acima do limite, Turnstile falho, JavaScript desligado e, para um teste: atribuição, o cookie fixo em uma segunda requisição, o endpoint de conversão. Em seguida, execute npx wrangler deploy --dry-run e verifique a contagem e o tamanho dos assets. Execuções locais não precisam de conta. Corrija o que falhar antes de prosseguir.

  8. Pare para autorização. Implantar, criar uma preview, adicionar um domínio personalizado ou rota, criar um banco de dados D1, executar d1 execute --remote, definir um segredo, criar o widget Turnstile e adicionar o site ao Web Analytics alteram a conta Cloudflare do usuário, e uma implantação ou mudança de DNS é visível ao público imediatamente. O usuário pode estar em meio a uma revisão, o domínio pode ainda servir um site antigo, e uma mudança de DNS errada pode derrubar um site ao vivo. Portanto, liste cada etapa externa com seu comando exato e o que ela mudará, e execute cada uma apenas quando o usuário disser sim a ela naquele momento. Um sim para uma etapa não é um sim para a próxima. Se o usuário preferir executá-las, entregue os comandos em ordem.

  9. Após a implantação (com o usuário). Envie o formulário ao vivo uma vez, confirme a linha no D1 e a conversão no Analytics Engine, confirme que o Web Analytics mostra a visita e verifique os itens na lista de verificação que só podem ser verificados ao vivo.

  10. Escreva landing/launch.md. Registre a configuração de hospedagem, a ação de conversão e como ela é contada, o plano A/B se houver, os comandos para as etapas externas e a lista de verificação de lançamento com cada item marcado como done, pending, fail ou n/a e o motivo para cada um que não seja done. Mostre a lista de verificação ao usuário.

Lista de verificação de lançamento

Copie isso para landing/launch.md e marque cada linha como done, pending (razão), fail (razão) ou n/a (razão). Um item que você não pôde verificar é pendente, nunca feito. Os itens do formulário são n/a quando a chamada para ação é uma página externa.

Conversão

  • A chamada para ação leva a uma ação funcional: o formulário envia para /api/lead (ou o endpoint existente do usuário), ou o link vai para a URL real do usuário. Nenhum href="#", auto-âncora ou sucesso falso.
  • Cada name de campo que o formulário envia tem uma entrada FIELDS com um limite de comprimento e uma coluna leads. Qualquer campo não tratado é uma falha, nunca uma aprovação.
  • Com um endpoint existente: ele responde JSON com ok para Accept: application/json e redireciona para /thanks/ ou /form-error/ caso contrário, ou as páginas de resultado correspondem ao que ele retorna; validação e proteção contra spam são registradas como sua responsabilidade.
  • Quando o formulário envia para o Worker desta habilidade: /thanks/ e /form-error/ existem (as próprias páginas da build, não substituídas), e /form-error/ oferece uma rota de contato do brief. Com um endpoint existente, as páginas correspondem ao que ele retorna; com um link externo, n/a.
  • Formulário testado localmente: post válido, email inválido, Turnstile falho, JavaScript desligado (cai em /form-error/).
  • O botão desabilita enquanto envia; sucesso e erro são anunciados em um elemento role="status".
  • O honeypot está oculto da vista e da tecnologia assistiva.
  • Formulário ao vivo testado uma vez após a implantação; a linha está no D1.
  • Nenhuma promessa de email de confirmação, a menos que o usuário tenha uma maneira de enviar um.

Medição

  • Snippet Web Analytics ao vivo com o token real em todas as páginas (pendente: o snippet está em um comentário HTML até que o token exista), incluindo /thanks/, /form-error/ e 404.html.
  • A conversão é escrita no Analytics Engine, e uma conversão de teste ao vivo aparece na consulta SQL.
  • Web Analytics mostra a visita ao vivo.
  • Durante um teste A/B: contagens de visitantes e conversões por variante aparecem, e o tamanho da amostra e a regra de encerramento são escritos em landing/launch.md.

Hospedagem

  • npx wrangler deploy --dry-run passa; arquivos de asset abaixo de 20.000, nenhum acima de 25 MiB.
  • Domínio personalizado serve a página via HTTPS; workers_dev definido como o usuário deseja.
  • Redirecionamentos em _redirects testados ao vivo.
  • Caminhos desconhecidos retornam o 404.html personalizado com status 404.

Página

  • Tags de título, meta descrição, URL canônica e Open Graph e cartão social presentes; a imagem do cartão carrega da URL ao vivo e a visualização parece correta quando o link é colado em um depurador de compartilhamento ou aplicativo de chat.
  • robots.txt e um sitemap que lista a URL ao vivo; páginas de resultado e previews são noindex.
  • Favicon presente.
  • Aviso de privacidade vinculado próximo ao formulário e no rodapé, nomeando Turnstile (um script do Cloudflare) e cada campo que o formulário armazena, pelo nome; detalhes de contato (email, telefone ou o canal de mensagens que o público realmente usa) e quem administra o site.
  • Qualquer declaração "sem cookies" ainda é verdadeira (não é enquanto um teste A/B define seu cookie).
  • Todo [PLACEHOLDER: ...] resolvido: fotos e screenshots reais no lugar, preços e datas confirmados.

Contas e segredos

  • Widget Turnstile criado para o hostname de produção; a sitekey real está no HTML.
  • TURNSTILE_SECRET definido com wrangler secret put (nunca commitado); .dev.vars* e .wrangler/ no .gitignore.
  • Cada etapa externa foi confirmada pelo usuário antes de ser executada.

Não usando Cloudflare

A build é saída estática simples: HTML, CSS, JavaScript e assets em uma pasta. Qualquer host estático ou o próprio servidor do usuário pode servir como está.

Se o usuário não quiser Cloudflare, não adicione arquivos Cloudflare: nenhum wrangler.jsonc, nenhum Worker, nenhum Turnstile, nenhum snippet Web Analytics, nenhum .dev.vars. Remova qualquer um que você tenha adicionado anteriormente na sessão. Em seguida, vá direto para a lista de verificação de lançamento e trabalhe nos itens que não nomeiam um produto Cloudflare. Para o formulário e a conversão, os itens da lista de verificação ainda se aplicam: o formulário precisa de um endpoint real no servidor ou serviço do usuário, validado no servidor, e a conversão precisa de uma maneira de ser contada. Nomeie o que está faltando, marque como pendente e deixe a escolha da ferramenta para o usuário. Esta habilidade não fornece receitas para outros hosts.

Autoverificação

Antes de relatar:

  • Nada foi implantado, previewado, roteado ou criado na conta do usuário sem um sim para essa etapa.
  • Cada mudança de configuração passou npx wrangler deploy --dry-run, e as verificações curl locais deram os códigos de status esperados.
  • Nenhum arquivo afirma que o Web Analytics conta cliques ou conversões.
  • Nenhum segredo, token ou id de conta é escrito em um arquivo commitado.
  • landing/launch.md existe, e cada linha da lista de verificação está marcada, com uma razão para cada uma que não seja done, e nenhum campo de formulário enviado fica sem tratamento.

Referências

  • references/hosting.md: configuração por stack, comandos, dry run, domínio personalizado, _redirects e _headers, cache, 404, previews. Leia na etapa 3.
  • references/forms.md: a marcação do formulário, o Worker do formulário testado, testes locais com chaves de teste Turnstile, configuração de produção. Leia na etapa 4 quando a página tiver um formulário.
  • references/analytics.md: configuração do Web Analytics, o evento de conversão no Analytics Engine, a consulta, declarações de privacidade, o que verificar após a implantação. Leia na etapa 5.
  • references/ab-testing.md: o custo no plano Free, o testado

… [truncado para tradução]

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Habilidades Relacionadas