Aparência
Testar e publicar
Selecionar ou trocar um tema
No editor, use Trocar tema para abrir o catálogo de temas em /admin/temas. Escolha um tema, confira sua demonstração e prepare a instalação no editor. A loja continua com o tema publicado até você usar Publicar. Se houver alterações pendentes ao sair do editor, confirme o descarte ou continue editando.
Atualizações dos temas oficiais, incluindo informações de produto, formulários de senha e menu de conta, entram em lojas existentes por uma nova revisão. Restaurar o original prepara os arquivos oficiais atuais; revise suas personalizações antes de publicar.
Primeiro tema após o cadastro
Ao criar uma loja no Node, a pergunta O que sua loja irá vender? permite preparar seu primeiro tema com IA em background. O painel mostra o andamento enquanto você continua a configuração. Esse fluxo pode publicar automaticamente a primeira revisão, desde que você ainda não tenha publicado um tema. Uma publicação sua durante a preparação é preservada.
A instância que recebe o cadastro inicia a preparação logo após confirmar a loja, sem esperar uma consulta periódica da fila. Dados e identidade começam em paralelo; as imagens usam a identidade pronta. Se o servidor for interrompido, após três minutos o acompanhamento oferece Tentar novamente; a retomada reaproveita o trabalho já salvo.
Na etapa Imagens, o painel informa quantas fotos já estão prontas. Se uma geração exceder o tempo disponível, a preparação oferece Tentar novamente e reaproveita as fotos já gravadas. Falhas isoladas de acompanhamento preservam a última etapa; se a sessão for recusada, use Entrar novamente para retomar o acompanhamento.
Os seis produtos fictícios vêm identificados como exemplos. Revise seus dados no cadastro de produtos antes de vender. O tema deve usar os objetos Liquid para exibir os dados do catálogo, preservando a identificação dos exemplos. Eles são criados com estoque zero e venda sem estoque habilitada; seus cards e ações de compra seguem a disponibilidade comercial normal na primeira Home. A preparação completa as fontes das listagens iniciais do Aura e retira filtros de estoque dessas vitrines. Depois, você pode definir filtros comerciais pelo editor normalmente.
A adaptação inicial personaliza a Home ao ramo, incluindo banner, categorias, vitrines, apresentação da marca e três depoimentos preenchidos sem rótulos de exemplo na vitrine. Ela começa em paralelo ao catálogo e à descrição da loja; as imagens começam depois, usando as cores e a descrição aprovadas. A IA recebe a composição JSON da Home, um contrato reduzido dos campos, os valores compartilhados pertinentes e o contexto da loja. Retorna alterações por campo em shared e sections, aplicadas somente a templates/home.json e aos valores compartilhados de editor.json, preservando logo, capas e fotos cadastradas. A personalização é exclusiva de cadastros novos V3, com revisão ativa zero, sem migração automática de lojas existentes. Definições, Liquid e CSS permanecem os arquivos preparados. A tarefa é enviada diretamente ao gpt-6.1-sol com esforço medium, sem uma chamada extra de interpretação. Campos omitidos preservam os valores atuais; tipos, limites e IDs são validados antes da aplicação. A qualidade das imagens permanece igual. O banner editorial começa com as demais imagens depois das cores e da descrição. A IA conhece o caminho assets/images/banner.webp, mas a primeira publicação usa um provisório. Não aguarda a geração nem a conversão para WebP. O banner entra por uma nova revisão quando pronto, se o lojista não tiver publicado outra revisão. As imagens de produto, logo e capas também entram conforme ficam disponíveis. Falhas preservam os provisórios e oferecem retomada no painel. O tempo total ainda depende do provedor; os diagnósticos separam a liberação da loja do fim das imagens.
A geração inicial não envia o manual e o código do bundle nem usa seu antigo prefixo de cache explícito. Envia apenas JSON e contexto; nenhuma resposta gerada é reutilizada. A primeira Home também passa por revisão do HTML: produtos, fotos, capas e logo cadastradas devem aparecer. Se um bloco perder seu vínculo comercial, a preparação recupera o Liquid funcional daquele bloco sem outra chamada à IA e preserva a personalização dos demais arquivos. Se a vitrine ainda estiver incompleta, ela não é publicada automaticamente.
As edições posteriores continuam livres para alterações amplas conforme seu pedido.
A geração pelo catálogo, a edição e a troca de temas depois dessa preparação inicial continuam sendo rascunhos que você revisa e publica explicitamente.
Prepare uma alteração revisável
Exporte a revisão aberta pelo menu •••, guarde o original e edite uma cópia. Ao gerar o ZIP, selecione os arquivos e pastas internos: theme.json precisa estar na raiz.
A importação valida o pacote e prepara uma revisão-base não ativa. O arquivo assets/theme.js deve permanecer idêntico ao da revisão-base. Scripts adicionais literais podem ficar diretamente nos arquivos Liquid e serão identificados pela IA; eles acompanham o rascunho e a publicação. O formato custom-codes.json continua suportado quando existente. Códigos gerais da loja não entram no ZIP. Consulte os limites e formatos aceitos.
Confira a prévia
Verifique as páginas afetadas, navegação, modos desktop e celular, foco de teclado, textos longos, listas vazias e produtos sem imagem. Preserve os hooks data-* quando alterar a estrutura de compra.
Ao abrir o editor, a preparação por clique analisa a página em segundo plano e confirma os alvos na prévia. No computador e no tablet, use Editar para abrir os formulários existentes de textos, banners e listagens, ou pedir alterações livres em blocos HTML como menu, logo, depoimentos e categorias. Editar mostra automaticamente etiquetas brancas compactas com nomes curtos e lápis nos blocos principais. Somente a etiqueta selecionada fica roxa e sua área recebe um contorno fino; clicar na etiqueta também abre a edição. Navegar esconde os indicadores e devolve os links e controles. As etiquetas também podem ser acionadas pelo teclado (Tab e Enter/Espaço), inclusive os controles de texto que aparecem ao receber foco. As cores do editor se limitam aos controles e marcações, preservando o tema na prévia. Editar/Navegar têm seleção exclusiva, e páginas/dispositivos compartilham a segunda barra com esses modos. Recolha o painel para ampliar a prévia. Ações rápidas e assistente continuam disponíveis durante a preparação e em caso de falha.
No celular, a prévia fica navegável e o botão fixo Editar tema abre o painel de seções. Escolha uma seção para acessar suas configurações. Os seletores de dispositivo e Editar/Navegar não aparecem no celular. O botão Aplicar alteração permanece visível nos formulários visuais, desabilitado sem mudanças ou durante o processamento. Fechar o painel preserva os campos e a prévia.
Essa preparação não modifica o bundle nem publica uma revisão. As identificações são acrescentadas somente à renderização da prévia do editor e não entram no ZIP. Os arquivos Liquid e CSS permanecem livres, sem settings visuais obrigatórios. Títulos dinâmicos ou com marcação interna podem receber seleção individual como HTML, preservando as variáveis. Outros textos dinâmicos/mistos e elementos ambíguos não recebem edição de texto literal; elementos compartilhados exigem conferir as demais ocorrências. As alterações dos formulários continuam sendo geradas com IA e precisam de revisão e publicação. O reaproveitamento da análise não recupera rascunhos descartados ao sair. Veja o guia de seleção por clique.
A prévia não comprova uma compra real: o runtime bloqueia mutações de carrinho, checkout e pagamentos nesse contexto. Conta e pedidos usam dados fictícios nas prévias de conta. Fluxos comerciais exigem homologação própria em ambiente autorizado.
Em um Codespace ou servidor de desenvolvimento com origem local configurada, Visitar loja pode abrir a revisão publicada usando o código desse servidor. A loja é selecionada pelo endereço público validado, e a navegação continua na mesma origem local. Essa visita usa a revisão publicada; alterações em rascunho continuam disponíveis pela prévia do editor. Em produção, o link continua abrindo o domínio público da loja.
Publique explicitamente
Use Publicar e confirme. Uma revisão publicada é imutável. No editor e no catálogo, alterar arquivos localmente, importar ou gerar uma proposta pela IA não substitui automaticamente a revisão ativa.
A criação inicial autorizada no cadastro prepara e publica a primeira vitrine. Nos novos trabalhos, catálogo com descrições, descrição da loja e JSON do tema começam em paralelo. A paleta do JSON orienta depois todas as imagens: fotos, logo, favicon, banner e capas. Banner e capas usam contexto textual e cores, sem fotos de referência. A publicação inicial aguarda os dados e a revisão funcional, mas não os pixels: a Home começa com imagens provisórias e atualiza somente essas áreas conforme cada imagem fica pronta. O banner é anexado por uma nova revisão imutável apenas se o lojista não tiver publicado outra revisão. Falhas de imagem mantêm a loja disponível; a retomada gera somente o que ainda falta. Trabalhos anteriores ao fluxo progressivo conservam seus checkpoints e a ordem anterior ao serem retomados. Revise o resultado antes de vender. Imagens enviadas pelo lojista e vitrines já publicadas são preservadas; edições posteriores seguem a publicação explícita descrita nesta página.
As capas geradas no cadastro são artes de coleção com o nome da categoria, composição quadrada e margem para recorte. No Aura, o CSS contém essas imagens em cards quadrados com object-fit: cover; suas dimensões originais não aumentam a altura do card. O nome e o link também permanecem no HTML. Fotos de produto e banners continuam usando suas orientações próprias. As mudanças de prompt e do tema-base não refazem capas nem substituem revisões de lojas já publicadas.
Os outros temas preservam seu formato: Brisa usa recorte 4 / 5, Nova e Cobalto usam 4 / 3, e Fluxo contém a foto dentro do card. Esses recortes não deixam a altura original da foto ampliar o bloco. Lumen e Vértice não possuem cards de capa na Home-base; Pulso apresenta categorias como links de texto.
Se outra operação publicou uma revisão enquanto você trabalhava, preserve seu rascunho e siga a indicação do editor para resolver a divergência. Não repita importações ou publicações indiscriminadamente após uma falha de rede.
A troca de logo também aguarda Publicar, mesmo quando nenhuma alteração de layout foi feita. Antes disso, somente a prévia mostra a imagem nova. Descartar troca de logo mantém a imagem publicada. Logo e layout são ativados juntos; se outra operação alterou o tema ou a logo global, resolva a divergência antes de publicar. A logo pertence à loja e permanece ao trocar de tema; não integra o ZIP.
Enquanto a loja não tiver uma logo publicada, o cartão Logo da loja fica visível no editor. Depois da publicação, abra Mais opções (•••) e escolha Alterar logo da loja para mostrar novamente o cartão, inclusive a opção de usar suas cores no tema.
No cartão Favicon da loja, você pode enviar uma imagem ou usar Gerar a partir da logo. Se a IA falhar, o editor cria o favicon diretamente da logo e avisa qual método foi usado. O favicon gerado também aguarda Publicar. Enquanto não houver um favicon publicado, o cartão fica visível no editor. Depois, use Mais opções (•••) → Alterar favicon da loja para abri-lo novamente.
Edite imagens no contexto da página
Use Trocar banner para escolher o banner da página e descrever a alteração. Você pode anexar uma nova arte ao pedido. Para imagens de outros elementos, descreva a mudança ao assistente ou use a ação específica do elemento quando disponível. A IA conhece os caminhos das imagens existentes no tema.
Não há recorte automático para celular. Prefira artes sem texto embutido e deixe títulos e botões no HTML do tema, que se adapta a cada tela. As alterações ficam no rascunho e entram na loja ao Publicar.
Histórico e restauração
O histórico resume as diferenças de arquivos entre cada versão e sua origem na mesma loja. Ao usar Visualizar versão, o editor abre uma página afetada quando possível, rola até os elementos identificados e os destaca brevemente. Uma alteração removida ou sem elemento visível pode não ter um ponto para destacar. A primeira versão sem origem indica a instalação inicial; cópias e revisões originadas no tema oficial são identificadas. Publicações novas informam trocas confirmadas de logo e favicon, mesmo quando o bundle não mudou. Revisões antigas sem esse registro não permitem identificar qual imagem foi alterada. Os horários são exibidos no fuso de São Paulo.
Restaurar uma versão ou o tema original prepara outra cópia para revisão; publicar continua sendo uma ação explícita. As versões posteriores são preservadas. O histórico exibe e mantém a logo global atual, sem restaurar logos antigas. Preparar uma restauração descarta a troca de logo ainda pendente.
Rascunhos e saída
Alterações da IA e a logo pendente ficam na memória do navegador e são descartadas ao sair confirmando o descarte. Rascunhos importados ou restaurados têm uma revisão-base persistida, mas alterações posteriores ainda precisam de publicação. Não há promessa de salvar e continuar entre sessões para todo o rascunho.
No menu Mais opções (três pontinhos), o link Documentação de temas abre em outra aba para você consultar os recursos sem sair da edição.
Disponibilidade da assinatura
Novas lojas criadas pelo cadastro Node recebem uma avaliação de sete dias, quando a estrutura comercial estiver provisionada. Ao terminar a avaliação sem contratação, o tema, as revisões e os demais dados da loja são preservados. A publicação e os recursos pagos ficam pausados; o titular pode entrar no painel para consultar a assinatura e contratar posteriormente.
A IA possui créditos separados das permissões de edição. Consultas de texto e imagens podem consumir quantidades diferentes. Consulte Minha conta → Assinatura para o consumo e a política aplicável. A contratação depende da integração com o faturamento da plataforma; o painel informa quando ela ainda não está disponível. Contratos legados conservam suas condições até uma migração controlada.
O novo Aura oferece Cores do tema nos controles compartilhados. Os valores ficam em editor.json e são renderizados pelo componente da paleta, sem cópia no CSS. A apresentação da marca usa os campos eyebrow, title, body e button_text da ocorrência na Home. O banner usa settings.slides, somente com imagens: a mensagem é escrita na imagem gerada pela IA no cadastro, e alt descreve cada slide. A IA do cadastro não pode redefinir campos nem editar Liquid/CSS; a edição posterior continua livre mediante pedido do lojista.
Imagens de banner por slide
Nos banners com controles de slides, Alterar imagem abre um modal para a versão desktop ou mobile escolhida, com upload, biblioteca do tema e Criar imagem com IA. A criação mostra uma prévia antes de usar a imagem. O pedido aceita uma referência PNG, JPEG ou WebP de até 5 MB e os formatos 16:9, 3:2, 1:1 e 2:3. No mobile, Adaptar imagem desktop usa a imagem efetiva do slide, inclusive um upload pendente. Títulos e botões continuam nos campos HTML, fora dos pixels.
Usar imagem aplica automaticamente o resultado na prévia daquele slide e dispositivo, incluindo o asset e sua referência no JSON do rascunho. Isso também vale para imagens geradas nos campos de imagem dos blocos. Não é preciso clicar em Aplicar alteração depois de confirmar a imagem da IA. Se um campo estiver inválido ou a aplicação falhar, corrija o problema e use Aplicar alteração para tentar novamente sem gerar outra imagem. O aviso Alterações não publicadas e a bolinha no botão Publicar indicam que a loja ao vivo ainda não foi atualizada; desaparecem depois da publicação. A geração é acompanhada em segundo plano e não publica revisões. Textos, links e demais slides são preservados. Confira a composição e publique pelo fluxo normal. Consulte o guia de criação de imagens de banner com IA.