Solucionar problemas de visualização e publicação

Corresponda estados de vitrine, compilação, publicação, checkout e domínio à ação segura mais próxima.

Caminho de entrada: Espaço de trabalho → selecione uma loja → Vitrine → reproduza o estado de visualização ou publicação mostrado na tela

O que este guia cobre

Identifique qual camada está falhando—versão do projeto, visualização, verificação de compilação, publicação, catálogo público, checkout ou domínio—e tome a menor ação de recuperação segura.

Por que essa distinção é importante

A jornada da vitrine tem várias camadas independentes. Repetir Publicar não pode corrigir dados de produto ausentes e atualizar Preview não pode reparar uma conexão de pagamento. Comece com a mensagem exata e a superfície que falhou.

Disponibilidade e pré-requisitos

Mantenha o projeto aberto e anote o rótulo de versão atual.
Registre a mensagem exata, caminho da página e se apareceu em Preview ou na URL pública.
Aguarde o trabalho ativo do Runner atingir Concluído, Falhou ou Parado antes de iniciar uma ação de recuperação conflitante.
Não remova domínios, restaure versões ou repita ações pagas apenas para testar uma teoria.

Encontre a camada com falha

Em Vitrine, verifique se existe uma versão atual.
Confirme se Preview normal abre.
Se você está publicando, leia o resultado da verificação de compilação antes de selecionar outra ação.
Se a publicação for bem-sucedida, abra a URL pública em vez da URL de visualização.
Na loja pública, teste o catálogo e o carrinho.
Verifique o status de checkout do Runner e o caminho de checkout real.
Se apenas o endereço personalizado falhar, verifique Domain Settings por último.

Controles de recuperação importantes

Controle	O que acontece quando selecionado
Atualizar em Preview	Recarrega a visualização atual e limpa a seleção de Design Mode ativa e a sessão de desfazer/refazer. Salve as edições diretas pendentes primeiro.
Corrigir / Corrigir erro	Envia o diagnóstico de visualização exibido ao Runner como uma solicitação de reparo. Dispensar apenas oculta a mensagem.
Corrigir com IA	Fecha a confirmação de publicação e envia sua falha de compilação ao Runner para reparo; a publicação não é iniciada.
Tentar verificação novamente	Executa novamente a verificação de compilação da vitrine após o Runner não conseguir alcançar o workspace.
Abrir Operações da loja	Fecha a confirmação de publicação e abre Operações da Loja para que você possa completar a configuração indicada.
Verificar novamente a configuração	Verifica novamente a prontidão de Operações da Loja após seu status estar indisponível.
Republicar	Inicia uma tentativa de publicação verificada e nova após uma falha ou resultado sem link. Corrija a causa nomeada primeiro.
Verificar novamente o checkout	Verifica novamente uma conexão de pagamento ativada; não testa um produto, envio ou o formulário de checkout.

Referência de estado para ação

Mensagem ou sintoma	Camada	O que significa	Ação segura mais próxima
Ainda não há loja	Versão do projeto	Não existe nenhuma versão que possa ser visualizada.	Peça ao Runner para criar a primeira vitrine.
Construindo a primeira versão da sua loja…	Versão do projeto	O Runner ainda está criando.	Acompanhe o progresso da tarefa; não publique ainda.
Falha na compilação em uma versão	Versão do projeto	Essa versão não está pronta.	Abra os detalhes da tarefa e peça ao Runner para reparar a falha.
Preparando a pré-visualização…	Visualização	O Runner está iniciando a visualização selecionada.	Mantenha a versão mais recente selecionada; atualize apenas se o progresso parar.
Falha ao carregar a pré-visualização desta versão.	Visualização	A versão selecionada não pôde ser exibida.	Retorne à atual, atualize ou tente outra versão pronta.
Reconnecting preview	Visualização	O Runner perdeu a conexão de visualização e está tentando novamente.	Acompanhe a contagem de tentativas; reconecte o workspace se a recuperação falhar.
Barra de erro de visualização com Corrigir	Visualização	A página em execução relatou um diagnóstico que o Runner pode usar.	Selecione Mostrar mais para inspecioná-lo, Corrigir ou Corrigir erro para enviá-lo ao Runner ou Dispensar apenas para ocultar a barra.
Página não encontrada	Rota de visualização ou pública	O caminho não existe nessa versão.	Retorne a `/`, use navegação visível e peça ao Runner para criar ou reparar a rota.
O modo de design não iniciou. A pré-visualização da loja pode ainda estar acordando — tente novamente.	Modo de Design	A visualização editável não ficou pronta.	Selecione Tentar novamente ou retorne à Visualização atual e atualize.
Editor visual desabilitado enquanto a IA está processando	Modo de Design	O Runner está tratando outra solicitação.	Aguarde o Runner terminar.
Não foi possível carregar o histórico de versões	Histórico de versão	A solicitação da lista de versões falhou.	Selecione Tentar novamente.
Restaurar está bloqueado	Histórico de versão	O Runner está ativo ou a versão não está pronta.	Aguarde o Runner e escolha uma versão pronta.
Não foi possível acessar seu espaço de trabalho. Tente a verificação novamente para continuar.	Verificação de publicação	O Runner não conseguiu executar a verificação de compilação.	Selecione Verificar novamente; reconecte o workspace se repetir.
Algo deu errado ao compilar sua loja. Corrija os erros antes de publicar.	Verificação de publicação	A vitrine atual não pode passar na compilação.	Selecione Corrigir com IA, revise o reparo e execute novamente as verificações.
A configuração da loja está incompleta. Pode publicar agora, mas alguns detalhes operacionais ainda precisam de atenção.	Configuração de publicação	Detalhes operacionais importantes da loja permanecem inacabados.	Selecione Abrir Operações da loja. Reconheça apenas se a limitação for intencional.
Não foi possível verificar Operações da loja. Tente novamente ou confirme e publique mesmo assim.	Configuração de publicação	O status de configuração é desconhecido.	Selecione Verificar novamente a configuração antes de considerar um reconhecimento.
Nenhuma alteração de código detectada desde a última implantação.	Alterações de publicação	O Runner não encontrou nada novo desde a última publicação.	Cancele ou reconheça uma nova implantação do mesmo estado apenas quando intencional.
A integração de pagamento não está configurada. Os clientes não poderão fazer pagamentos em sua loja publicada até que você conecte o Stripe nas Configurações.	Configuração de checkout	Alguns fluxos de publicação mostram isso antes do lançamento quando nenhuma conexão de pagamento ativada é encontrada.	Conecte o Stripe; use o reconhecimento apenas para um lançamento somente de navegação intencional. Outros fluxos relatam o status do checkout após a publicação.
Falha ao publicar a loja	Publicação	A tentativa não foi concluída.	Repare o problema indicado e selecione Republicar.
Link da loja indisponível	Entrega da publicação	A tentativa terminou sem uma URL pública utilizável no Runner.	Feche o diálogo, confirme que o workspace está pronto e selecione Republicar.
A loja pública mostra conteúdo antigo	Publicação ou versão	As alterações mais recentes do projeto não estão ao vivo.	Confirme a versão atual mais recente, selecione Publicar Alterações e reabra a URL pública.
Produto ausente na loja pública	Catálogo	A publicação foi bem-sucedida, mas o produto pretendido não está visível.	Verifique status do produto, mercado, preço e inventário; publique alterações se necessário.
Ação do carrinho ausente ou desativada	Catálogo ou disponibilidade	O item selecionado não pode ser adicionado atualmente.	Verifique opções necessárias, disponibilidade, estoque, preço e região.
Checkout em pausa	Pagamento	O fluxo pós-publicação não encontrou uma conexão Stripe ativada.	Selecione Conectar Stripe e teste novamente o caminho de checkout real.
Estado do checkout indisponível	Status de pagamento	O Runner não consegue confirmar a prontidão de pagamento.	Selecione Verificar novamente o checkout e teste o checkout público independentemente.
Domínio personalizado próprio mostra um aviso vermelho e uma tabela Tipo / Host / Valor	Domínio	A verificação da configuração atual do provedor ainda não passou.	Copie exatamente os valores exibidos para seu provedor. O Runner verifica novamente de forma automática enquanto as Configurações de Domínio permanecem abertas; não há botão de verificação manual.
Transferência em andamento	Domínio	Um domínio está se movendo entre lojas.	Não inicie outra transferência; acompanhe o status mostrado.

Relate um problema ao Runner

Incluir esses detalhes em uma mensagem:

o caminho exato da página ou URL pública;
se falhou em Preview ou na loja ao vivo;
o rótulo de versão atual;
o texto exato de erro ou estado;
o último botão que você selecionou;
o resultado esperado; e
se o problema se reproduz após a ação de tentativa documentada.

Para um problema visual, inclua o layout do dispositivo e uma captura de tela. Para checkout, pare antes de uma cobrança real e relate a última etapa bem-sucedida.

Limites de recuperação

Não retome ou republique repetidamente um estado com falha inalterado. Corrija a causa nomeada primeiro.
Não restaure uma versão mais antiga enquanto o Runner está trabalhando.
Não remova um domínio para corrigir um problema de vitrine ou checkout.
Não declare sucesso de lançamento até que a URL pública, catálogo pretendido, carrinho e etapa de checkout necessária tenham sido verificados.