Um site no Solta mostra uma página em branco
O site foi publicado, o link abre, e não tem nada. Quase sempre o navegador recusou alguma coisa ou o código parou, e o navegador diz qual das duas. Se for um ficheiro React que fica em branco em qualquer lado fora do Claude, e não só no Solta, comece por porque é que um artefacto React do Claude abre em branco (em inglês).
Primeiro, veja a consola
Abra o site no seu próprio endereço (your-site.solta.site, não dentro do Solta) e depois a consola do navegador: clique com o botão direito, Inspecionar (Inspect) e depois Consola. Ou, no Chrome, ⌥⌘J num Mac e Ctrl Shift J nos outros computadores. Uma linha vermelha aí é o motivo, e costuma dizer algo parecido com uma das secções abaixo.
Se fez o site com uma IA, cole essa linha vermelha na mesma conversa. É a coisa mais útil que lhe pode dar, e a correção passa a ser uma nova versão do mesmo site.
A mensagem “Refused to load the script”
A página carrega uma biblioteca de um servidor a partir do qual os sites não podem carregar scripts. Cada site tem uma Content Security Policy (política de segurança de conteúdo) que lhe permite carregar scripts de si próprio e destas CDN públicas, as 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 lado é bloqueado, e quando é esse script que desenha a página, a página fica vazia. Carregue a mesma biblioteca de uma dessas CDN (quase todos os pacotes públicos estão no jsDelivr ou no cdnjs), ou publique uma pasta com o ficheiro lá dentro e carregue-o por um caminho relativo.
O código parou ao correr
Um erro Uncaught quer dizer que o código começou e deu erro antes de desenhar fosse o que fosse. Um componente React que o Solta não consegue preparar é recusado quando publica, e o erro aparece. Um que fica pronto pode ainda falhar quando corre: 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 da própria aplicação de chat, que só existem dentro dela. No Solta, um site chama um modelo através do seu próprio endereço, e guarda dados através do armazenamento do Solta ou do navegador.
Um import não foi encontrado
Os pacotes que um componente React importa são obtidos em esm.sh pelo navegador do visitante. Um pacote que não foi publicado no npm, o caminho para um ficheiro seu que não foi enviado com ele (./utils num único ficheiro colado) ou uma rede que bloqueia o esm.sh deixam a página sem nada para correr. Mais sobre imports.
A build de uma aplicação numa pasta
Uma pasta é servida exatamente como está, a partir da raiz do endereço próprio do site. Uma build feita para um subcaminho (/my-repo/assets/…, como costuma ser uma build para o GitHub Pages) pede ficheiros que não estão lá. Faça a build para a raiz (no Vite, base: "./" ou "/") e envie o que a build produziu, com o index.html no nível de cima, e não o código-fonte do projeto.
Precisa de um servidor
Uma página que vai buscar dados a localhost, a um endereço http:// simples ou a 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 corre 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 suas próprias páginas e os leitores de YouTube, Vimeo, Google Maps, Spotify, SoundCloud e Loom, usando o endereço de incorporação de cada um (como youtube.com/embed/…). Para tudo o resto, ponha um link.
Continua em branco depois de tudo isto? Use Comunicar um problema no menu do site: envia-nos a versão que está a ver, e nós analisamos.

