burtyish / craco

Create React App Configuration Override, an easy and comprehensible configuration layer for create-react-app

CRACO

Create React App Configuration Override is an easy and comprehensible configuration layer for create-react-app.

Get all the benefits of create-react-app and customization without using 'eject' by adding a single configuration (e.g. craco.config.js) file at the root of your application and customize your eslint, babel, postcss configurations and many more.

All you have to do is create your app using create-react-app and customize the configuration file.

Support

• Create React App (CRA) 4.*
• Yarn
• Yarn Workspace
• NPM
• Lerna (with or without hoisting)
• Custom react-scripts version

Documentation

• Installation - How to install and setup CRACO.
• Configuration - How to customize your CRA installation with CRACO.
  • Configuration File
  • Configuration Helpers
  • Exporting your Configuration
  • Setting a Custom Location for the configuration file
• CRA Toolchain for Beginners
  • Notes on CRA Configurations and Problem Solving
  • Ejecting CRA to Learn
  • Direct Versus Functional Config Definitions
• API - CRACO APIs for Jest and Webpack.
  • Jest API
  • Webpack API
• Recipes – Short recipes for common use cases.
• Available Plugins - Plugins maintained by the community.
• Develop a Plugin - How to develop a plugin for CRACO.
• Backward Compatibility
• Debugging

Community Maintained Plugins

• craco-preact by @DocSpring
• craco-less by @DocSpring
• craco-antd by @DocSpring
• craco-plugin-react-hot-reload by @hasanayan
• craco-plugin-single-spa-application by @hasanayan
• craco-babel-loader by @rjerue
• craco-raw-loader by @melMass
• craco-base64-inline-loader by @melMass
• craco-workbox by @kevinsperrine
• craco-use-babelrc by @jackwilsdon
• craco-image-optimizer-plugin by @kkulbae
• craco-interpolate-html-plugin by @kkulbae
• craco-cesium by rot1024
• craco-sass-resources-loader by tilap
• craco-linaria by jedmao
• craco-plugin-scoped-css by gaoxiaoliangz
• craco-alias by @risenforces
• craco-favicons by @rickysullivan
• craco-styled-jsx by @cr4zyc4t
• craco-purescript-loader by @andys8
• craco-fast-refresh by @vimcaw
• craco-parameter-decorator by @Hokid
• storybook-preset-craco by @danielknell

Acknowledgements

@timarney for having created react-app-rewired.

License

Copyright © 2020, Groupe Sharegate inc. This code is licensed under the Apache License, Version 2.0. You may obtain a copy of this license at https://github.com/gsoft-inc/gsoft-license/blob/master/LICENSE.