SFRA ou PWA Kit? A decisão que define os próximos anos da sua arquitetura
Um guia técnico para Tech Leads que precisam justificar essa escolha para o negócio, sem virar dívida técnica no caminho.
Falar com quem já migrou os doisPor que essa escolha é mais estratégica do que técnica
Salesforce Commerce Cloud (SFCC) oferece hoje dois caminhos oficiais de frontend: SFRA (Storefront Reference Architecture), o modelo server-side rendering com templates ISML consolidado desde 2018, e PWA Kit, o framework headless baseado em React para construir storefronts via Composable Storefront API (segundo a documentação oficial da Salesforce).
A escolha errada não aparece no primeiro sprint. Aparece 18 meses depois, quando o time precisa entregar uma feature de personalização que o SFRA não suporta bem, ou quando o custo de manter um build React customizado supera o ganho de performance que justificou a migração.
Este guia organiza os critérios técnicos que realmente pesam nessa decisão: arquitetura, performance, SEO, curva de aprendizado do time, custo de manutenção e cenários em que cada opção vence.
SFRA vs PWA Kit: comparativo técnico direto
Critérios que mais impactam decisão de arquitetura em times de e-commerce de crescimento rápido.
| SFRA | PWA Kit | |
|---|---|---|
| Modelo de renderização | Server-side rendering (SSR) com templates ISML, processados diretamente no servidor do SFCC. | React com SSR via Managed Runtime; separação clara entre frontend e backend via API. |
| Curva de aprendizado do time | Exige domínio de ISML, SCAPI e das convenções específicas do SFCC. Menor barreira para quem já vem de Java/Demandware. | Exige domínio sólido de React, Node.js e arquitetura headless. Barreira maior para times sem bagagem em SPA/SSR moderno. |
| Performance percebida (Core Web Vitals) | Bom o suficiente na maioria dos casos, mas limitado pelo ciclo de request/response tradicional do servidor. | Maior controle sobre LCP, CLS e TTFB por permitir otimizações de bundle, cache de API e renderização granular. |
| Flexibilidade de UI/UX | Limitada pela estrutura de templates ISML e componentes pré-definidos. Customizações profundas exigem mais esforço. | Total liberdade de componentização React; ideal para experiências ricas, PWA instalável e microinterações complexas. |
| Velocidade de entrega inicial (MVP) | Mais rápido para lojas padrão, aproveitando cartridges e funcionalidades prontas do SFRA. | Mais lento no início: exige montar a camada de apresentação do zero sobre a API. |
| SEO técnico | SSR nativo favorece indexação sem esforço extra de configuração. | SSR via Managed Runtime também entrega bom SEO, mas exige atenção a hidratação e meta tags dinâmicas. |
| Custo de manutenção a médio prazo | Tende a crescer conforme customizações se acumulam em cima de uma arquitetura server-side rígida. | Mais previsível quando a separação de responsabilidades entre API e frontend é respeitada desde o início. |
| Integração com canais além da web (app, IoT, voice) | Não foi desenhado para isso; exige trabalho adicional significativo. | Arquitetura headless facilita reaproveitar a mesma API para outros canais. |
| Maturidade e suporte oficial Salesforce | Referência histórica, ampla documentação e comunidade consolidada desde 2018. | Investimento ativo da Salesforce como caminho estratégico para composable commerce, mas com menos anos de maturidade em produção. |
Como decidir: um checklist técnico em 5 perguntas
Antes de escolher, responda essas perguntas com o time de arquitetura e liderança de produto.
Qual é o nível de customização de UI que o roadmap de produto exige?
Se o negócio pretende construir experiências de UI muito diferentes do padrão de e-commerce (configuradores complexos, PWA instalável, microinterações elaboradas), PWA Kit dá mais liberdade. Se as necessidades são as de uma loja tradicional bem executada, SFRA entrega isso com menos esforço de engenharia.
O time atual tem profundidade em React/Node ou em Java/ISML?
Migrar para PWA Kit sem gente com experiência real em arquitetura headless React gera retrabalho e bugs de performance que anulam o ganho teórico. Avalie honestamente a bagagem técnica disponível antes de decidir pela arquitetura mais nova.
Qual é a janela de tempo para o primeiro release?
Prazos apertados para MVP costumam favorecer SFRA, que já vem com boa parte da jornada de compra pronta. PWA Kit compensa o investimento inicial maior em prazos mais longos ou quando já existe base de componentes reutilizável.
Existe plano real de omnicanalidade (app nativo, outros touchpoints)?
Se a mesma camada de API vai alimentar app mobile, kiosks ou outros canais no médio prazo, a arquitetura headless do PWA Kit evita reescrever integrações. Se o escopo é só a loja web, esse argumento perde peso.
Qual é o apetite para dívida técnica de médio prazo?
SFRA tende a acumular customizações em cima de uma base rígida; PWA Kit tende a degradar quando a separação de camadas não é respeitada. Nenhuma arquitetura é imune a dívida técnica, a diferença é onde ela se acumula.
Migração não é reescrita: dá para evoluir sem parar o negócio
Muitos times de e-commerce enxergam a escolha entre SFRA e PWA Kit como um evento único e definitivo. Na prática, é possível rodar migrações incrementais, validando o PWA Kit em jornadas específicas (busca, PDP, checkout) antes de expandir para toda a loja.
Esse tipo de decisão exige experiência prévia real com as duas arquiteturas, porque os trade-offs de performance, cache e SEO mudam de página para página. Especialistas alocados que já passaram por essa migração em outros projetos SFCC reduzem o risco de retrabalho, sem exigir que você aumente o time interno para isso.
O que fazer com esse comparativo
Nenhuma tabela substitui uma avaliação do seu contexto específico: stack atual, maturidade do time, prazo de negócio e roadmap de produto. O valor deste guia é dar vocabulário técnico comum para a conversa entre Tech Lead, liderança de e-commerce e stakeholders de negócio.
Se a decisão entre SFRA e PWA Kit está travada por falta de experiência prática nas duas arquiteturas dentro do time, esse é exatamente o tipo de lacuna que se resolve com especialistas alocados por projeto, sem comprometer o headcount interno nem a velocidade da decisão.
Valide a decisão antes de comprometer o roadmap
Um diagnóstico técnico gratuito com especialistas que já implementaram SFRA e PWA Kit em produção ajuda a mapear riscos de performance, SEO e manutenção antes da decisão ser tomada, não depois.
