# Guia: o checklist que conserta o site de IA que fica estranho no celular

> Um guia do @souoallan. Site feito com IA costuma ficar estranho quando tu abre no celular: tu toca num campo e a
> página inteira dá zoom, o botão fica com outra cor depois do toque, o fim da tela some atrás da barra do navegador.
> Antes de publicar, manda a lista abaixo pro Claude Code ou pro Codex, dentro do projeto do teu site. Ele confere e
> conserta tudo sozinho.

## Como usar

1. Abre o projeto do teu site no Claude Code (no app do Claude, a aba Code) ou no Codex.
2. Copia o prompt inteiro abaixo e cola no chat.
3. Clica em Permitir quando ele pedir. No fim ele te diz o que precisa ser conferido num celular de verdade.

## O prompt (cola inteiro)

```
Antes de publicar, confere e conserta este site pra celular. Pra cada item, procura no projeto e corrige do jeito indicado:

TOQUES
- Botão fica com a cor do hover depois do toque: coloca todo :hover dentro de uma media query (hover: hover) and (pointer: fine).
- Pisca um cinza quando a pessoa toca: põe -webkit-tap-highlight-color: transparent e dá um estado :active próprio pra tudo que é tocável.
- O toque demora pra responder: adiciona touch-action: manipulation nos botões e links.
- Segurar o botão seleciona o texto dele: põe user-select: none nos botões e controles, não no texto corrido.
- Ícone pequeno é difícil de acertar: usa um pseudo-elemento pra aumentar a área de toque pra 44px sem mudar o visual.

CAMPOS
- A página inteira dá zoom quando a pessoa toca num campo: fonte de no mínimo 16px nos campos, e não desliga o zoom com maximum-scale=1 nem user-scalable=no.
- Abre o teclado errado: inputmode="decimal" pra valor, inputmode="numeric" pra código de verificação, type="email" e type="tel" pra e-mail e telefone.

TELA
- Dá pra arrastar a página pros lados: nada de rolagem lateral e nada vazando da tela.
- O fim da tela corta quando a barra de endereço aparece: usa 100dvh nas sobreposições de tela cheia e nos layouts de página inteira, 100svh no topo (hero), não 100vh.
- O notch e a barrinha de baixo do iPhone cobrem as barras de cima e de baixo: adiciona viewport-fit=cover no viewport e dá espaço nas barras com env(safe-area-inset-*).

Pula o que esse projeto não tiver. Quando terminar, me diz quais desses não aparecem no emulador de celular do computador e precisam ser conferidos num celular de verdade.
```

## Os 10 problemas, em português simples

| O que acontece no celular | O que o Claude conserta |
|---|---|
| Botão fica com a cor do "passar o mouse" depois do toque | O efeito de mouse só vale em computador |
| Pisca um cinza quando tu toca | Tira o cinza e dá um efeito de toque próprio |
| O toque demora pra responder | Botões e links respondem na hora |
| Segurar o botão seleciona o texto | Botão não seleciona mais |
| Ícone pequeno difícil de acertar | Área de toque de 44px, sem mudar o visual |
| A página dá zoom quando tu toca num campo | Letra dos campos com no mínimo 16px |
| Abre o teclado errado | Teclado de número, e-mail ou telefone no campo certo |
| Dá pra arrastar a página pros lados | Nada vaza da tela |
| O fim da tela some atrás da barra do navegador | Altura de tela certa pro celular |
| O notch do iPhone cobre o topo | Espaço certo nas bordas do iPhone |

## Depois

Abre o site no teu celular (e, se der, num Android e num iPhone) e testa: toca nos botões, nos campos e rola até o fim.
