Adeus Yo? O SPFx CLI chega para substituir o Yeoman

Se você desenvolve SharePoint Framework, o comando que mais digitou nos últimos anos provavelmente foi este:

yo @microsoft/sharepoint

Isso está mudando. A Microsoft está trocando o generator Yeoman pelo SharePoint Framework CLI (@microsoft/spfx-cli) — e o novo comando já tem cara de futuro:

spfx create \
  --template webpart-react \
  --library-name my-spfx-library \
  --component-name "Hello World"

O que está acontecendo

Não é “Yeoman some do npm amanhã”. É troca de ferramenta oficial de scaffold.

O generator legado (@microsoft/generator-sharepoint) amarrava a ferramenta de criação à versão do SPFx: atualizar template exigia publicar um generator novo. O CLI corta esse nó:

  • Templates vêm em runtime do repositório open-source SharePoint/spfx
  • Você escolhe a versão com --spfx-version (ex.: 1.23, 1.23-rc.0)
  • Dá para apontar templates da empresa (--local-source / --remote-source)
  • O próprio CLI é open-source e aceita contribuição

Na documentação oficial, a Microsoft já chama o Yeoman de legacy e o CLI de substituição. Depois da GA, o plano é um update final no Yeoman do SPFx e fim da evolução nele. Projetos antigos continuam; o que muda é como você cria solução nova.

Como fica o fluxo (já documentado)

npm install -g @microsoft/spfx-cli

spfx list-templates

spfx create \
  --template webpart-react \
  --library-name my-spfx-library \
  --component-name "Hello World" \
  --spfx-version 1.23 \
  --package-manager npm

Em vez do questionário interativo do yo, o scaffold vira flags explícitas — melhor pra script, CI e template corporativo.

Datas e releases (com ressalva)

O calendário oficial ainda oscila entre páginas. O que dá pra cravar com o que a Microsoft publicou até agosto/setembro de 2026:

  • SPFx 1.23 — já em GA (maio/2026). Foi nela que o preview do CLI e dos templates open-source apareceu.
  • SPFx 1.24 — em preview pública (beta.3 em ago/2026). GA mirando outubro/2026, com React 18 e Copilot Components (antes “SharePoint Copilot Apps”).
  • SPFx 1.25 — janela dezembro/2026 a janeiro/2027: evolução dos Copilot Components, navigation customizers e, no roadmap do blog de agosto, a GA do SPFx CLI.

Atenção: a página de roadmap do Microsoft Learn e o blog de developers já divergiram sobre em qual release a CLI vira GA (1.24 vs 1.25). O pacote npm ainda anda em pré-release (0.1.0-pre.x). Trate setembro/outubro como alvo em movimento — a Microsoft prometeu novo update de roadmap no fim de setembro.

O que isso muda no dia a dia

  • Time de plataforma: hora de montar templates internos e apontar o CLI pra eles, em vez de forks tortos do Yeoman.
  • Dev SPFx: vale instalar o preview, rodar spfx create num repo de teste e comparar o output com o yo atual.
  • Produção: não migre o pipeline de scaffold oficial até a GA. Preview é pra validar, não pra virar padrão do time.

No mesmo pacote da 1.24 (contexto útil)

Enquanto o CLI amadurece, a 1.24 traz dois assuntos que todo mundo que mexe com SPFx vai esbarrar: React 18 de verdade no framework e Copilot Components — UI SPFx renderizando no canvas do Microsoft 365 Copilot. São frentes paralelas; o CLI é a troca de ferramenta, esses dois são a troca de superfície.

Veredito

yo @microsoft/sharepoint ainda funciona. Mas o caminho recomendado — e o que a Microsoft vai investir — é spfx create.

Se você mantém web parts, extensions ou um gerador interno da empresa, o momento certo pra olhar o CLI é agora: ainda em preview, já com docs e repo público, antes da corrida da GA.

Referências:

Você já testou o spfx create ou ainda está 100% no Yeoman? Conta nos comentários.

Post baseado em fontes públicas da Microsoft (Learn, GitHub e blog Microsoft 365 Developer). Datas de GA podem mudar — confira o roadmap oficial antes de planejar migração.

**GA** = *General Availability* — disponibilidade geral.

É quando o produto (ou a feature) sai do preview/beta e vira versão oficial: suportada, documentada e recomendada pra produção.

- **antes da GA** = preview, pode mudar, bom pra testar

- **depois da GA** = Microsoft considera pronto; aí faz sentido virar padrão do time (e aí o Yeoman do SPFx tende a parar de evoluir)

Comentários

Postar um comentário