Na BigCommerce, a vitrine pode ser feita de duas formas. Com Stencil, a loja usa um tema hospedado pela própria plataforma, com templates em Handlebars e o Page Builder para ajustes sem código. Com Catalyst, a vitrine é uma aplicação Next.js separada, que consome a GraphQL Storefront API e que a sua equipe hospeda e mantém. Nos dois casos, catálogo, pedidos e checkout continuam na BigCommerce.
A resposta curta: Stencil atende quando um tema bem personalizado e os aplicativos de vitrine resolvem a experiência que você quer. Catalyst faz sentido quando a interface ou o conteúdo exigem código próprio e existe uma equipe para manter uma aplicação Next.js, com hospedagem e atualizações. Este guia é para quem já está considerando a BigCommerce e precisa dimensionar o projeto da vitrine. Se a dúvida ainda é a viabilidade no Brasil, leia antes BigCommerce no Brasil.
Qual é a diferença entre um tema Stencil e o framework Catalyst?
A tabela compara o que a documentação oficial descreve para cada caminho, consultada em 20/10/2026.
| Aspecto | Stencil | Catalyst |
|---|---|---|
| O que é | Motor de temas da plataforma | Framework headless de vitrine |
| Tecnologia | Handlebars, Sass ou SCSS, front matter em YAML, biblioteca stencil-utils | Next.js, React Server Components, Tailwind CSS, GraphQL Storefront API |
| Ponto de partida | Tema Cornerstone, de código aberto, em três variações | CLI ou criação pelo painel; visual de “folha em branco” para estilizar |
| Onde roda | Na BigCommerce | Native Hosting da BigCommerce (beta fechado), Vercel ou outro provedor compatível |
| Edição sem código | Page Builder | Makeswift, na variante do Catalyst com Makeswift |
| Checkout | Checkout da plataforma | Redirecionado para o checkout hospedado pela BigCommerce |
| Licença do código | Tema Cornerstone aberto no GitHub | Licença MIT |
A diferença que mais pesa no orçamento não é a tecnologia, é a responsabilidade. No Stencil, a BigCommerce hospeda a vitrine e você mantém o tema. No Catalyst, você é dono de uma aplicação inteira: código, hospedagem, cache, monitoramento e atualizações. Esse é o mesmo dilema discutido em quando avaliar e-commerce headless.
Como ficam autonomia editorial, customização e dependências?
Autonomia editorial
No Stencil, o Page Builder permite que a equipe de marketing ajuste cores, tipografia, banners, títulos, carrossel e rodapé, além de quantidades de produtos em painéis e páginas de categoria e marca, sem programar.
No Catalyst, a edição visual vem do Makeswift. A documentação diz que o Catalyst é distribuído em duas variantes: uma sem Makeswift e outra com a integração. A instalação pelo painel já cria o projeto com Makeswift; a instalação pela linha de comando usa a variante sem Makeswift, a menos que se peça a outra. Defina isso no início, porque muda o que a equipe de conteúdo vai conseguir fazer sozinha.
Customização e recursos
A documentação do Catalyst mantém uma tabela de recursos da plataforma com três estados: suportado, parcialmente suportado e não suportado. Na consulta de 20/10/2026:
- Suportados: avaliações de produtos, grupos de clientes com visibilidade e preço, vale-presente, GA4, carrinho persistente, promoções no carrinho e multiloja (um domínio por projeto).
- Parciais: aplicativos, cartões salvos (usados no checkout, mas não gerenciáveis na área do cliente), sitemap, Script Manager e o portal de compras B2B, que é experimental.
- Não suportados: banners do painel (a orientação é usar o Makeswift), Meta Pixel, links de pedido rascunho e de carrinho abandonado aplicados à sessão, mensagens no pedido depois do checkout e embalagem para presente, que pode ser construída pela API.
Como o código é seu, os itens parciais e não suportados podem ser desenvolvidos. Cada um vira escopo, custo e manutenção.
Dependências de aplicativos
Este é o ponto que mais surpreende. Segundo a documentação, aplicativos de back-office, voltados ao painel e às operações, funcionam com o Catalyst, e aplicativos que expõem API podem ser integrados com código. Já os aplicativos de vitrine, que alteram o comportamento do front-end, em geral não funcionam com o Catalyst. Se o seu plano depende de aplicativos que inserem avaliações, chat, selos ou pop-ups na loja, liste cada um e confirme a compatibilidade.
Para SEO, o sitemap do Catalyst cobre as URLs gerenciadas pela BigCommerce, como produtos, marcas e categorias. Páginas criadas no Makeswift ficam de fora e precisam de sitemap adicional. Esse é o tipo de item que deve constar no SEO do projeto da loja virtual.
Como avaliar hospedagem, apps compatíveis e governança de evolução?
Hospedagem
A documentação compara duas hospedagens testadas para o Catalyst. A Native Hosting é da própria BigCommerce, construída sobre a Cloudflare, mas está em beta fechado e pode ter mudanças incompatíveis nas APIs. A Vercel é um fornecedor terceiro, com assinatura separada. Em outros provedores, é preciso configurar um armazenamento externo para o cache de rotas; sem ele, o cache fica só na memória de cada servidor. Na Native Hosting, a documentação indica uma implantação de pré-visualização por projeto, enquanto na Vercel há pré-visualização por branch.
No Stencil, essa decisão não existe: a vitrine roda na plataforma.
Governança de evolução
O Catalyst usa versionamento semântico. A branch padrão do repositório contém o código em desenvolvimento, que pode não ser estável; as versões estáveis são marcadas por tags. A própria documentação avisa que mudanças grandes podem gerar conflitos de mesclagem em projetos personalizados. Reserve horas de atualização no orçamento recorrente.
No Stencil, a manutenção é do tema. A documentação traz um exemplo de por que isso importa: com o PCI 4.0, scripts passam a exigir autorização por nonce e verificações de integridade, e a orientação é atualizar o Cornerstone para a versão 6.16.0 ou superior. Um tema muito modificado torna esse tipo de atualização mais trabalhoso.
Matriz de decisão Stencil ou Catalyst (modelo copiável)
A matriz é documental: foi montada com a documentação oficial, sem teste prático. Dê peso de 1 a 3 a cada critério e marque para qual lado a sua resposta aponta.
| Critério | Peso (1–3) | Pergunta | Aponta para Stencil quando | Aponta para Catalyst quando | Sua resposta |
|---|---|---|---|---|---|
| Equipe técnica | Quem mantém o código depois do lançamento? | Equipe ou agência domina temas e Handlebars | Há equipe com Next.js e React disponível | ||
| Aplicativos de vitrine | A loja depende de apps que mudam o front-end? | Sim, e eles são essenciais | Não, ou dá para substituir por integração | ||
| Conteúdo e campanhas | Marketing precisa montar páginas sozinho? | Ajustes do Page Builder bastam | Precisa de componentes próprios no Makeswift | ||
| Interface | O tema pronto limita a experiência? | Um tema personalizado resolve | A experiência exige código próprio | ||
| Medição e anúncios | Meta Pixel e scripts são críticos? | Sim, sem desenvolvimento extra | Equipe pode implementar no código | ||
| Recursos de pós-venda | Carrinho abandonado e mensagens no pedido são usados? | Sim, como estão hoje | Podem ser refeitos ou dispensados | ||
| B2B | O portal de compras B2B é necessário já? | Sim, com estabilidade | Pode esperar a integração sair do modo experimental | ||
| Hospedagem | Quem paga e opera a hospedagem? | Prefere não ter esse custo | Aceita Vercel ou o beta da Native Hosting | ||
| Atualizações | Há orçamento recorrente para atualizar a base? | Pouco orçamento recorrente | Horas reservadas por versão |
Em qualquer dos dois, pagamento, frete e nota fiscal passam pelo checkout da BigCommerce. Esses critérios não decidem entre Stencil e Catalyst; eles decidem se a BigCommerce serve para a sua operação no Brasil.
Arquitetura ilustrativa dos dois caminhos
| Etapa | Com Stencil | Com Catalyst |
|---|---|---|
| Navegação e busca | Tema na BigCommerce | Aplicação Next.js na hospedagem escolhida |
| Edição de páginas | Page Builder | Makeswift ou código |
| Dados de catálogo | Plataforma | GraphQL Storefront API |
| Checkout | Plataforma | Redirecionado para o checkout da plataforma |
| Pedidos, ERP e nota | Integrações da plataforma | Integrações da plataforma |
Próximo passo
A SouLoja não implanta a BigCommerce. Se a matriz apontou para Catalyst e o custo de manter uma aplicação própria pesou, compare outras plataformas na matriz para escolher a plataforma de e-commerce. Se quiser uma segunda opinião sobre o escopo, peça uma avaliação do seu projeto de loja virtual, considerando as plataformas que atendemos.
