Migração automatizada do Storefront 1.0 para o 2.0

O Storefront 2.0 traz um checkout totalmente integrado ao modelo do Storefront, mais flexibilidade e um setup padronizado.
Agora você pode migrar de forma automática (recomendada) ou manual.

❗️

Importante!

O processo automatizado só está disponível para lojas que estejam no Storefront 1.0.

Migração Automática (recomendada)

A migração automática permite criar uma nova branch já pronta para ajustes, sem precisar seguir todo o processo manual.

Como funciona

  1. Acesse o menu Repositório no painel da sua loja.
  2. Clique em Migração Automática.
  3. Escolha o nome da nova branch e marque a opção Migrar para Storefront 2.0.
  4. O sistema irá:
  • Comparar os arquivos da sua loja com o template padrão Wake.
  • Copiar para a nova branch apenas os arquivos diferentes.
  • Ignorar arquivos que já existirem no destino (sem sobrescrever).
  • Incluir automaticamente os arquivos de checkout 2.0.
  1. Um relatório será exibido mostrando os arquivos migrados e os que precisam de ajustes manuais.

Exemplos de ajustes manuais

  • Páginas de hotsite (ex.: checkout.html).
  • Ícones duplicados já existentes no template da loja.

Esses casos aparecem listados no final da migração, para que sua agência possa revisar.

Resultado

  • Uma nova branch será criada contendo:
    • Todos os arquivos originais da loja.
    • Arquivos necessários para o Storefront 2.0.
    • Checkout atualizado.
  • Orientações claras sobre os próximos passos.

Migração Manual

Se preferir ou em casos específicos, ainda é possível realizar a migração manualmente.
Esse processo segue o passo a passo tradicional, copiando arquivos do repositório oficial e ajustando o checkout.

👉 Veja o guia completo da migração manual aqui

Boas práticas

  • Sempre crie uma branch específica para a migração.
  • Revise os avisos exibidos no final da migração automática.
  • Teste o checkout no ambiente de homologação através do botão "Pré-visualizar" antes de publicar.


👉 Com esse fluxo, sua loja pode migrar com muito mais rapidez, padronização e segurança.