Um site no Solta mostra uma página em branco
O site foi publicado, o link abre, e não há nada nele. Quase sempre o navegador recusou alguma coisa ou o código parou, e o navegador diz qual dos dois. Se for um arquivo React que fica em branco em qualquer lugar fora do Claude, não só no Solta, comece por por que um artefato React do Claude abre em branco (em inglês).
Primeiro, olhe o console
Abra o site no endereço próprio dele (your-site.solta.site, não dentro do Solta) e depois o console do navegador: clique com o botão direito, Inspecionar (Inspect) e depois Console. Ou, no Chrome, ⌥⌘J no Mac e Ctrl Shift J nos outros computadores. Uma linha vermelha ali é o motivo, e ela costuma dizer algo parecido com uma das seções abaixo.
Se você fez o site com uma IA, cole essa linha vermelha de volta na mesma conversa. É a coisa mais útil que você pode dar a ela, e a correção vira uma nova versão do mesmo site.
A mensagem “Refused to load the script”
A página carrega uma biblioteca de um servidor do qual os sites não podem carregar scripts. Todo site tem uma Content Security Policy (política de segurança de conteúdo) que permite carregar scripts do próprio site e destes CDNs públicos, os que as páginas escritas por IA usam:
esm.shcdnjs.cloudflare.comcdn.jsdelivr.netunpkg.comcdn.tailwindcss.comcode.jquery.com
Um <script src> de qualquer outro lugar é bloqueado, e quando é esse script que desenha a página, ela fica vazia. Carregue a mesma biblioteca de um desses CDNs (quase todo pacote público está no jsDelivr ou no cdnjs), ou publique uma pasta com o arquivo dentro e carregue-o por um caminho relativo.
O código parou ao rodar
Um erro Uncaught quer dizer que o código começou e deu erro antes de desenhar qualquer coisa. Um componente React que o Solta não consegue preparar é recusado quando você publica, e o erro aparece. Um que fica pronto ainda pode falhar quando roda: ao ler algo que não existe, ou ao chamar uma função que a página nunca definiu.
Um caso comum em páginas escritas dentro de um chat: código que chama funções do próprio aplicativo de chat, que só existem dentro dele. No Solta, um site chama um modelo pelo próprio endereço, e salva dados pelo armazenamento do Solta ou pelo do navegador.
Um import não foi encontrado
Os pacotes que um componente React importa são buscados em esm.sh pelo navegador do visitante. Um pacote que não foi publicado no npm, o caminho para um arquivo seu que não foi enviado junto (./utils num único arquivo colado) ou uma rede que bloqueia o esm.sh deixam a página sem nada para rodar. Mais sobre imports.
O build de um app numa pasta
Uma pasta é servida exatamente como está, a partir da raiz do endereço próprio do site. Um build feito para um subcaminho (/my-repo/assets/…, como costuma ser um build para o GitHub Pages) pede arquivos que não estão lá. Gere o build para a raiz (no Vite, base: "./" ou "/") e envie o que o build produziu, com o index.html no nível de cima, e não o código-fonte do projeto.
Ele precisa de um servidor
Uma página que busca dados de localhost, de um endereço http:// comum ou de uma API que não deixa outros sites chamá-la não recebe nada de volta, e muitas páginas não desenham nada até esses dados chegarem. O Solta não roda nenhum código de servidor seu. Veja onde fica esse limite.
Só uma parte está vazia
Um quadro (frame) de outro site dentro do seu fica vazio enquanto o resto funciona: um site pode mostrar num quadro as próprias páginas e os players de YouTube, Vimeo, Google Maps, Spotify, SoundCloud e Loom, usando o endereço de incorporação de cada um (como youtube.com/embed/…). Para qualquer outra coisa, coloque um link.
Continua em branco depois de tudo isso? Use Relatar um problema no menu do site: isso nos envia a versão que você está vendo, e nós analisamos.