Repolode
Enviar
timarney

timarney/react-app-rewired

Um helper de config-overrides que permite personalizar as configurações do webpack, do Jest e do servidor de desenvolvimento do Create React App sem fazer eject.

Ver no GitHub
Estrelas
9,836
Forks
418
Issues abertas
25
Último commit
mês passado

O que é?

react-app-rewired permite modificar a configuração do webpack de um projeto Create React App sem executar eject nem fazer fork de react-scripts. Basta colocar um arquivo config-overrides.js na raiz do projeto, exportando uma função que recebe a configuração padrão do webpack e retorna a versão modificada. Adicionar plugins, loaders ou outros ajustes ao build passa a ser só uma questão de editar esse arquivo.

Além da configuração do webpack, o mesmo arquivo pode personalizar a configuração do Jest, a do servidor de desenvolvimento do webpack e os caminhos usados pelo CRA. As configurações do Jest também podem ser ampliadas pela seção jest do package.json, e os plugins Babel para testes podem ser definidos em uma seção babel ou em .babelrc. Forks personalizados de react-scripts, como react-scripts-ts, são compatíveis por meio de uma opção de linha de comando.

Ao usar a ferramenta, você abre mão das garantias de suporte normalmente oferecidas pelo Create React App, pois passa a manter a configuração modificada por conta própria. O projeto informa que recebe apenas manutenção limitada e lista alternativas como customize-cra, Rescripts e craco.

Recursos principais

  • 01Amplia a configuração padrão do webpack do CRA por meio de uma função em config-overrides.js.
  • 02Personaliza a configuração do Jest, incluindo o setup do Babel para testes.
  • 03Sobrescreve a configuração do servidor de desenvolvimento do webpack, como os certificados HTTPS.
  • 04É compatível com pacotes react-scripts personalizados por meio de uma opção de linha de comando.
  • 05Pode ser usado com um diretório config-overrides ou com o caminho de um arquivo personalizado.

Casos de uso

  • Adicionar um plugin ou loader personalizado do webpack a um projeto Create React App sem fazer eject.
  • Configurar certificados HTTPS para o servidor de desenvolvimento do CRA.
  • Ajustar as configurações do Jest ou os plugins Babel para testes em um app CRA.

Início rápido

  1. 1

    Instale react-app-rewired como dependência de desenvolvimento

    npm install react-app-rewired --save-dev
  2. 2

    Crie config-overrides.js na raiz do projeto e exporte uma função override

  3. 3

    Altere os scripts start, build e test do npm para usar react-app-rewired em vez de react-scripts

  4. 4

    Inicie o servidor de desenvolvimento

    npm start

Antes de usar

  • O projeto recebe manutenção limitada, principalmente da comunidade, e não oferece suporte.
  • Ele foi desenvolvido para Create React App 2.x com Webpack 4; versões anteriores do CRA precisam da versão 1.6.2 fixada.
  • Ao personalizar a configuração, você assume a responsabilidade por ela e pode comprometer as garantias do CRA.

Tópicos

#react#webpack#create-react-app#config#jest#build-tool#eject#never

Perguntas frequentes

O que é react-app-rewired?
Um helper de config-overrides que permite personalizar as configurações do webpack, do Jest e do servidor de desenvolvimento do Create React App sem fazer eject. react-app-rewired permite modificar a configuração do webpack de um projeto Create React App sem executar eject nem fazer fork de react-scripts. Basta colocar um arquivo config-overrides.js na raiz do projeto, exportando uma função que recebe a configuração padrão do webpack e retorna a versão modificada. Adicionar plugins, loaders ou outros ajustes ao build passa a ser só uma questão de editar esse arquivo.
react-app-rewired é gratuito? Qual é a licença?
react-app-rewired é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
react-app-rewired ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de react-app-rewired foi em 3 de out. de 2026.
Para que posso usar react-app-rewired?
Adicionar um plugin ou loader personalizado do webpack a um projeto Create React App sem fazer eject. Configurar certificados HTTPS para o servidor de desenvolvimento do CRA. Ajustar as configurações do Jest ou os plugins Babel para testes em um app CRA.
Como instalar react-app-rewired?
Instale react-app-rewired como dependência de desenvolvimento: npm install react-app-rewired --save-dev Crie config-overrides.js na raiz do projeto e exporte uma função override Altere os scripts start, build e test do npm para usar react-app-rewired em vez de react-scripts Inicie o servidor de desenvolvimento: npm start
Onde consigo react-app-rewired?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/timarney/react-app-rewired

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados