Publicar landing em subdomínio com painel de edição
Você converte uma landing já aprovada em um site implantado com painel. Você não redige copy nem redesenha: o que entra é o HTML aprovado; o que sai é uma URL funcionando, medindo e legal.
Regra de ouro
Não se implanta nada sem o OK explícito do usuário sobre o layout. Se a landing ainda não foi aprovada, pare e devolva o controle para a skill de landing correspondente.
Como é executado: piloto automático
Direção não quer ficar respondendo perguntas. Decida você e avance. Tudo o que segue já está resolvido e não se pergunta:
- Qual hospedagem usar → diz o
dig +short NS(FASE 0.5). - Como se chama o projeto → kebab-case do cliente + ângulo (
Cliente14-metodo). - O que é editável → títulos, subtítulos, bullets, textos de botão, eliminadores de objeções, passos, avaliações, FAQ, números, imagens, IDs de medição, textos do aviso de cookies e todo o conteúdo da página de agradecimento.
- Montar a página de agradecimento e o banco de dados → vêm de série, não são extras que se perguntam.
- Criar o repo, implantar, criar os registros DNS, ativar o SSL, remover marcas d'água da hospedagem → faz-se, não se consulta.
- Adicionar um CNAME ou um TXT no DNS do cliente → é aditivo, faz-se (ver FASE 0.5).
As únicas três paradas legítimas:
- O HTML aprovado não está claro ou há mais de um candidato. Pergunte qual é e não adivinhe: o arquivo mais óbvio no disco pode ser uma versão antiga. Peça para colarem se houver dúvida.
- Falta um dado que você não pode inventar: ID do GTM ou do pixel, um embed de vídeo, um telefone. Pede-se; nunca se preenche com um placeholder.
- Um segredo ou um pagamento. O
client_secret, as senhas e comprar coisas você nunca toca (ver FASE 8).
Todo o resto: vá em frente, e no final informe o que foi feito.
Contas, sessões e navegadores (verificado 11-09-2026)
Saber qual conta e qual Chrome tem cada coisa economiza meia sessão. Nenhuma senha passa por você: se um acesso pedir senha ou código, pare e passe para Direção.
As contas
| Serviço | Conta | Para quê |
|---|---|---|
| GitHub | <usuario-github> (SSH já configurado) | Repositórios das landings. ssh -T [email protected] confirma |
| Cloudflare | <email-conta-de-trabalho> | Pages: aqui vivem todas as landings. Já tem conectado o app do GitHub de <usuario-github> |
| Netlify | ⚠️ duas contas, não as confunda | Apenas para migrar sites antigos PARA FORA. Não se implanta nada novo |
↳ equipe <conta-de-trabalho> | <email-conta-de-trabalho> | Sem créditos ("operational credits"): implantações pausadas |
↳ equipe Fb | <email-direcao> | Tem tiseraconstrucciones.com, plano gratuito, pendente de migrar |
| Clarity | um projeto por landing | Cria-se em clarity.microsoft.com; o ID vai para o painel |
Os dois Chrome
Geralmente há dois navegadores conectados. O que cada um tem de sessão:
| Chrome | Sessões |
|---|---|
<conta-de-trabalho> | Cloudflare, GitHub, Netlify equipe <conta-de-trabalho> |
<email-direcao> | Área de cliente da Sered (do cliente), Typeform, Netlify equipe Fb |
- Não faça Direção escolher entre deviceIds: eles não significam nada. Use
switch_browsere avise em uma linha: "aparece um botão Connect, clique no que tiver X aberto". - Se um site pedir login e nesse Chrome não houver conta salva, tente o outro antes de perguntar.
- Se o Google mostrar o seletor de contas, escolher a conta não é inserir uma senha: pode-se fazer. Se depois pedir senha ou código, pare.
🚨 Sered é a conta DO CLIENTE
A área de cliente da Sered no Chrome <email-direcao> está logada como o cliente (no Cliente 14, "Bem-vindo, Alejandro"). Lá dentro só se tocam os registros da landing (o CNAME e seu TXT de verificação). Nada da zona que você não criou.
Rota: Área de cliente → Entrar no cPanel → Zone Editor → Manage do domínio.
🚨 Apagar um site da Netlify exige a conta que o possui
Se o Chrome está logado na outra equipe, o projeto dá Page not found mesmo que exista. É preciso encerrar a sessão (app.netlify.com/logout) e entrar novamente com Google escolhendo a conta correta. Isso encerra a sessão da outra conta nesse Chrome: avise Direção que fez isso.
🚨 Campos de formulários React: form_input, não escrever
Em painéis feitos com React (o assistente do Keystatic, o formulário do Pages), escrever com computer type deixa a tela em branco. form_input fixa o valor diretamente e funciona. Para menus suspensos que form_input não altera, abra-os com um clique e escolha a opção.
PASSO 0 — Dados que você precisa
- O HTML aprovado. Se você veio encadeada de outra skill, é o
index.htmljá montado. Se está procurando no disco, confirme que é o vigente: procure comgrep -rl --include="*.html" -i "<cliente>" ~/Desktop ~/Downloadse se aparecer mais de um, ou o que tem parece material de aula ou de uma pasta que não é do cliente, pergunte. Publicar a versão antiga obriga a refazer a conversão inteira. - Nome do projeto em kebab-case (
Cliente14-metodo). É o nome do repositório e do projeto na hospedagem. - Subdomínio (
metodo.cliente.com). NÃO pergunte onde está o DNS: você descobre. - Qual formulário a landing usa: Tally ou Typeform. Não se pergunta, olha-se no HTML (
grep -oE "data-tf-live|data-tally-src"). Muda o embed, os campos ocultos e o webhook (FASE 9). - ID do Google Tag Manager e/ou do pixel do Meta, se houver (FASE 3).
- Favicon e logo do cliente, se você os tiver (FASE 4).
Antes de converter, revise o HTML procurando placeholders não preenchidos:
# O arquivo é OBRIGATÓRIO: sem ele, o grep fica lendo stdin e trava o turno.
grep -nE '\{\{[A-Z0-9_]+\}\}|VIDEO_ID|SUBDOMINIO|TODO:|XXXX|LOREM|placeholder|Lorem ipsum' <arquivo.html>
⛔ [A-Z0-9_], COM DÍGITOS. O regex que estava aqui era [A-Z_]+ e os placeholders da casa têm número: testado, de {{H1_LINEA_1}}, {{FUD_1}}, {{VP_1_TITULO}}, {{URL_LOGO_PRENSA_1}} e {{SUBDOMINIO}} só capturava o último. Ou seja, o controle que existe para "um placeholder jamais sair publicado" deixava passar quatro de cada cinco, bem antes de publicar.
Qualquer achado bloqueia essa seção e pergunta-se. Um placeholder jamais sai publicado.
⛔ FASE 0.5 — HOSPEDAGEM: uma única rota (11-09-2026)
A landing é ESTÁTICA. Não há SSR, não há adaptador, não há decisão a tomar.
Antes havia uma árvore de decisão conforme onde estivesse o DNS do cliente. Já não: existia porque os Custom Domains do Cloudflare Workers exigem a zona DNS dentro do Cloudflare, e isso só importa se você precisar de servidor. A landing não precisa.
| Peça | Onde roda |
|---|---|
| A landing | HTML estático |
| O formulário | iframe do Tally/Typeform, no navegador |
| A medição (GTM/pixel) | navegador |
| O aviso de cookies | localStorage |
| Os leads | do formulário para o CRM, não passam por nós |
| O painel do Keystatic | local, npm run dev. Não é implantado |
Hospedagem: Cloudflare Pages. Sempre, seja qual for a hospedagem do cliente. O Pages aceita um CNAME de qualquer DNS — Sered, IONOS, Hostinger, GoDaddy, cPanel de uma hospedagem local, seja o que for —, e como não há SSR não é preciso o adaptador que deixou de suportá-lo.
Plano gratuito: 500 builds/mês, 100 projetos, 100 domínios por projeto, sem medir largura de banda.
⚠️ Por que NÃO Netlify (verificado 11-09-2026, não repita)
Netlify passou a créditos: 300/mês no plano gratuito, e uma implantação de produção custa 15. São 20 implantações por mês para TODOS os sites da conta juntos — e cada vez que alguém salva no painel, isso é um commit e uma implantação.
Mas o grave não é o limite: ao esgotar os créditos, o Netlify PAUSA todos os seus sites e o visitante vê Site not available. No plano gratuito é um limite duro, não se podem comprar mais. Uma landing de cliente com campanhas ativas fica caída. É desqualificante para trabalho de cliente, não um incômodo.
⚠️ Por que NÃO Vercel (verificado, não repita)
O plano gratuito do Vercel (Hobby) é apenas para uso NÃO comercial. A própria documentação: "the Hobby plan restricts users to non-commercial, personal use only". Uma landing de cliente é uso comercial: seria necessário Pro (20 $/mês por usuário).
A única coisa que precisa descobrir: onde está o DNS
Não é o mesmo a hospedagem e o DNS. Mandam os nameservers: um cliente pode ter o site na Sered e os NS no Cloudflare, e então o painel da Sered não serve de nada.
dig +short NS <dominio-do-cliente>
Isso diz qual painel pedir acesso antes de pedir, e consulta-se sem credenciais. Muitas vezes nem é preciso acesso: você passa o registro já escrito e o cliente ou seu técnico cria em dois minutos.
🚨 cPanel e Plesk criam um registro A que quebra o CNAME
Ao criar um subdomínio, cPanel e Plesk criam sozinhos um registro A apontando para o servidor deles. Um CNAME não pode coexistir com um A do mesmo nome — é assim que o DNS funciona, não é um capricho do painel.
É preciso apagar esse A ou o CNAME nunca resolve. É o erro que mais faz perder tempo, porque o painel mostra tudo "correto".
Regras sobre o DNS do cliente
- NUNCA proponha mover os nameservers como primeira opção. O email (MX), o site e as verificações (TXT) dependem disso: replicar mal um registro deixa o cliente sem email. É a última saída, e com o OK explícito dele.
- Adicionar um CNAME ou um TXT novo NÃO é mover o DNS. É aditivo: não toca no MX nem no site existente. Isso se faz sem dramatizar.
- COMPRAR UM DOMÍNIO NOVO NÃO É OPÇÃO. NUNCA. Não proponha, nem como plano B. A landing sempre depende de um subdomínio do domínio que o cliente já tem.
- Como explicar quando houver dúvidas:
"É um registro NOVO para um subdomínio que hoje não existe. Não modifica nem apaga nada: o email (MX), o site e as verificações continuam intactos. Se algo der errado, apaga-se esse registro e tudo volta como estava."
- Se realmente não houver acesso ao painel do cliente, a landing fica em
<projeto>.pages.deve as campanhas começam com ela. Provisório e avisado, mas nunca se compra um domínio para resolver. - Credenciais do cliente: você não as gerencia. Você diz exatamente qual registro criar e verifica depois que resolve. O acesso é usado por Direção ou pelo cliente.
🚨 NÃO consulte o subdomínio antes de criá-lo
dig +short metodo.cliente.com # ⛔ NÃO FAÇA ISSO ANTES DE CRIAR O REGISTRO
O SOA de muitos provedores fixa o cache negativo em 86400 s (24 horas). Se você perguntar pelo subdomínio antes de ele existir, os resolvers guardam o "não existe" um dia inteiro — o seu, e às vezes o da autoridade certificadora. Resultado: o certificado demora ou falha e parece um erro de configuração quando não é.
Verifique o SOA para saber a que está enfrentando sem perguntar pelo subdomínio:
dig +short SOA <dominio> # o último número é o TTL do cache negativo
FASE 1 — Montar o projeto
Stack mínimo. Sem Tailwind e sem Fontsource: as skills de landing geram CSS puro com !important e trazem suas próprias fontes no bloco mestre. Colocar Tailwind só adiciona bugs.
E sem adaptador. Não instale @astrojs/netlify nem @astrojs/cloudflare: a saída é estática.
npm create astro@latest <projeto> -- --template minimal --install --no-git --skip-houston --yes
cd <projeto>
npm install @keystatic/core @keystatic/astro @astrojs/react react react-dom @astrojs/sitemap zod
npm install -D @astrojs/check typescript
Versões verificadas executando (11-09-2026): astro 7.3.2 · @keystatic/core 0.6.9 · @keystatic/astro 6.0.0 · @astrojs/react 6.0.5 · react 19.3.0.
astro.config.mjs — única versão
// @ts-check
import { defineConfig } from 'astro/config';
import react from '@astrojs/react';
import keystatic from '@keystatic/astro';
import sitemap from '@astrojs/sitemap';
// Keystatic APENAS em dev. No build sai HTML puro: sem rotas /api, sem
// runtime do React, sem adaptador. O painel é usado localmente e commita.
const isDev = process.argv.includes('dev');
export default defineConfig({
// Enquanto o subdomínio não existir, aponte para a URL REAL da hospedagem.
// Um site: que não resolve emite canonical e sitema
... [truncado para tradução]