Neste artigo
- Migrar Create React App Vite: guia em 8 passos com zero downtime em 2026
- Por que sair agora
- Antes de tocar em qualquer coisa
- Os 8 passos da migração
- Vite puro ou Next.js?
- Erros que quebram a migração
- Checklist de regressão visual
- O Create React App morreu de vez?
- Migrar para Vite quebra o projeto?
- Quanto tempo leva para migrar?
- E se eu quiser ir para Next.js em vez de Vite puro?
Migrar Create React App Vite: guia em 8 passos com zero downtime em 2026
O Create React App foi descontinuado oficialmente em 14 de fevereiro de 2025 e hoje roda só em modo de manutenção. Se a sua equipe ainda está presa nele, dá para migrar Create React App Vite em fases, sem parar o produto.
O plano abaixo tem 8 passos e um checklist de regressão visual no fim. O aviso oficial está no post de sunset do blog do React.
Por que sair agora
O CRA nasceu em 2016 para resolver um problema real: montar JSX, lint e hot reload na mão era trabalhoso. Só que hoje ele trava em ferramentas paradas.
Com React 19.3.1, Next.js 16.4.5 e Vite 8.3.5 no registro oficial (react, vite, next), ficar no CRA custa caro. O build fica lento e cada novedade passa longe do seu projeto.
Antes de tocar em qualquer coisa
- crie um branch só para a migração;
- confirme que os testes automatizados estão verdes hoje;
- congele deploys de novas features durante a semana de migração;
- tire prints das telas principais para comparar depois.
Os 8 passos da migração
- passo 1: instale o Vite no projeto e crie o arquivo de configuração básico;
- passo 2: mova o HTML de entrada para a raiz que o Vite exige;
- passo 3: ajuste o ponto de entrada do app e os imports de CSS e imagens;
- passo 4: troque os scripts do pacote, o comando de dev passa a ser o do Vite;
- passo 5: renomeie as variáveis de ambiente de REACT_APP_ para o prefixo VITE_;
- passo 6: revise rotas e imports absolutos que o CRA resolvia sozinho;
- passo 7: ajuste o pipeline de CI para rodar build e testes com o comando novo;
- passo 8: faça o deploy em paralelo e só depois troque o tráfego, comparando com os prints.
O guia oficial de migração cobre cada um desses pontos em detalhe: vite.dev/guide/migration.
Vite puro ou Next.js?
Depende do tipo de app. Um projeto só de frontend, como um painel interno, resolve bem com Vite puro, que é mais leve. Agora, se o app precisa de SEO forte, rotas de servidor ou pré-render, vá de Next.js.
Erros que quebram a migração
- esquecer de renomear as variáveis de ambiente, e o app quebra silenciosamente em produção;
- deixar algum import absoluto que o CRA resolvia e o Vite não resolve;
- migrar tudo de uma vez, sem branch dedicada, e perder a referência do que funcionava;
- trocar o tráfego antes do deploy em paralelo e derrubar o site no meio do dia.
Checklist de regressão visual
- a homepage carrega igual, com os mesmos estilos;
- o fluxo principal funciona de ponta a ponta;
- os formulários enviam e mostram erro direitinho;
- o build de produção gera sem aviso novo;
- as métricas de performance não pioraram depois da troca.
Perguntas frequentes
O Create React App morreu de vez?
Morreu para projetos novos. O time do React descontinuou o CRA em 14 de fevereiro de 2025 e deixou o projeto em manutenção, com uma última versão compatível com o React 19.
Migrar para Vite quebra o projeto?
Não, se a migração for em fases: branch dedicada, testes verdes antes e checklist visual depois. Com deploy em paralelo, o zero downtime é real.
Quanto tempo leva para migrar?
Um projeto médio leva de alguns dias a uma semana, dependendo do tamanho da base de código e de quantos truques do CRA o projeto usava.
E se eu quiser ir para Next.js em vez de Vite puro?
Também dá. O blog do React mantém um guia próprio de migração do CRA para Next.js, cobrindo rotas, busca de dados e renderização no servidor.
Pronto para começar? Veja o guia de migração do Vite passo a passo e comece pelo branch dedicado hoje.
Para continuar estudando, veja o guia do primeiro emprego em TI, a editoria de programação e o artigo sobre React Server Components.