Customize react templates
Learn how to theme, customize, and extend CoreUI React Templates with Sass, a boatload of global options.
Overview#
There are multiple ways to customize CoreUI for React. Your best path can depend on your project, the complexity of your build tools, the version of CoreUI for React you're using, browser support, and more.
Our two preferred methods are:
- You can extend our source files.
- You can override CoreUI’s styles.
File structure#
Utilize our source Sass files to take advantage of variables, maps, mixins, and functions to help you build faster and customize your project.
Whenever possible, avoid modifying CoreUI's core files. For Sass, that means creating your own stylesheet that imports CoreUI for React so you can modify and extend it. Assuming you're using a package manager like npm, you'll have a file structure that looks like this:
your-project/├── ...├── node_modules/│ ├── @coreui/coreui │ │ ├── scss│ │ └── ...│ └── @coreui/react│ └── ...├── src│ └── scss│ ├── _custom.scss│ ├── ...│ ├── _variables.scss│ └── ...└── ...If you use CoreUI PRO version.
your-project/├── ...├── node_modules/│ ├── @coreui/coreui-pro │ │ ├── scss│ │ └── ...│ └── @coreui/react-pro│ └── ...├── src│ └── scss│ ├── _custom.scss│ ├── ...│ ├── _variables.scss│ └── ...└── ...Variable defaults#
Every Sass variable in CoreUI for React includes the !default flag allowing you to override the variable's default value in your own Sass without modifying CoreUI's source code. Copy and paste variables as needed, modify their values, and remove the !default flag. If a variable has already been assigned, then it won't be re-assigned by the default values in CoreUI.
You will find the complete list of CoreUI's variables in node_modules/@coreui/coreui/scss/_variables.scss or in node_modules/@coreui/coreui-pro/scss/_variables.scss. Some variables are set to null, these variables don't output the property unless they are overridden in your configuration. You can also find a specific component variables list in Customizing section ex. Alerts - Customizing
Here's an example that changes the background-color and color for the <body> when importing and compiling CoreUI for React via npm:
// _variables.scss
// Default variable overrides$body-bg: #000;$body-color: #111;Custom styles and overrides#
In your custom.scss, you can put custom code for CoreUI's components or your own styles.
// _custom.scss
// Additional custom code here.custom-component { border: 2px solid #222;}