Testar no Mobile

Use o seletor de viewport responsivo no builder para uma verificação rápida, depois publique e teste em um dispositivo real para qualquer coisa que envolva comportamentos exclusivos do mobile.

Existem duas camadas para testes mobile no Proyecta: o preview responsivo dentro do builder e o teste em dispositivo real a partir de uma URL publicada.

Preview responsivo no builder

O painel de preview inclui um seletor de viewport na barra de endereço:

Modo	Dimensões
Desktop	Largura total da janela
Tablet	768 × 1024
Mobile	390 × 844

Alterne entre eles durante a edição para identificar problemas de layout cedo. Essa é a forma mais rápida de detectar bugs responsivos óbvios (overflow, grids quebrados, botões impossíveis de tocar).

Abra no seu celular com um QR code

A forma mais rápida de testar em um dispositivo real é pela aba Mobile → Test do dashboard. Assim que seu app estiver publicado, ela exibe um QR code — escaneie com a câmera do celular para abrir o app ao vivo instantaneamente. Há também um botão Copy link caso prefira enviar a URL para si mesmo. (Se você ainda não publicou, a aba solicita que você publique primeiro — o teste no dispositivo requer uma URL ao vivo.)

Teste em um dispositivo real

O seletor de viewport apenas simula dimensões — ele não simula entrada por toque, latência do mundo real, peculiaridades de browsers mobile ou comportamentos específicos de cada plataforma. Para tudo o que realmente importa (interações por toque, prompts de instalação, notificações push, câmera, GPS), teste em um dispositivo real:

1. Publique seu app no subdomínio *.proyecta.live
2. Abra a URL no browser do seu celular
3. Se você adicionou suporte a PWA, escolha Add to Home Screen e teste a experiência instalada
4. Percorra os fluxos que são importantes para você

Coisas que só é possível detectar em um dispositivo real

• Tamanho das áreas de toque — dedos são maiores do que ponteiros de mouse
• Elementos fixos (sticky) — unidades de viewport se comportam de forma diferente com o chrome do browser mobile
• Entrada em formulários — preenchimento automático, tipos de teclado, autocomplete
• Peculiaridades do iOS Safari — problemas com 100vh, scroll com bouncing, posicionamento fixo
• Fluxo de permissão para notificações push — funciona apenas em uma origem publicada via HTTPS em uma aba de browser de nível superior; não será acionado dentro do painel de preview do builder (mesmo quando o preview já é servido via HTTPS).
• Desempenho em hardware real (mais lento)

Dicas para testes

• Use as ferramentas de desenvolvedor do seu celular. O Safari no macOS pode se conectar ao Safari mobile para depuração ao vivo; o Chrome pode se conectar ao Chrome no Android.
• Teste também no modo paisagem. A maioria dos devs testa apenas no modo retrato e acaba perdendo bugs no modo paisagem.
• Teste com o modo de baixo consumo ativado. Animações e timers se comportam de forma diferente.
• Teste em um iPhone real para push em PWA. Notificações push no iOS só funcionam a partir de um PWA instalado via Safari.