🎉 Limited offer! Get a Pro license and save up to $1.000. 🎉 Learn more

Webpack

Learn how to include CoreUI in your project using Webpack 3.

Installing CoreUI

Install CoreUI as a Node.js module using npm.

npm install @coreui/coreui

Importing JavaScript

Import CoreUI’ JavaScript by adding this line to your app’s entry point (usually index.js or app.js):

import 'coreui';

Alternatively, you may import plugins individually as needed:

import 'coreui/js/dist/ajax-load';
import 'coreui/js/dist/sidebar';
...

CoreUi is dependent on Bootstrap, jQuery and Popper, these are defined as peerDependencies, this means that you will have to make sure to add both of them to your package.json using npm install --save bootstrap jquery popper.js.

Notice that if you chose to import plugins individually, you must also install exports-loader

Importing Styles

Importing Precompiled Sass

To enjoy the full potential of CoreUI and customize it to your needs, use the source files as a part of your project’s bundling process.

First, create your own _custom.scss and use it to override the built-in custom variables. Then, use your main Sass file to import your custom variables, followed by CoreUI:

@import "custom";
@import "~coreui/scss/coreui";

For CoreUI to compile, make sure you install and use the required loaders: sass-loader, postcss-loader with Autoprefixer. With minimal setup, your webpack config should include this rule or similar:

  ...
  {
    test: /\.(scss)$/,
    use: [{
      loader: 'style-loader', // inject CSS to page
    }, {
      loader: 'css-loader', // translates CSS into CommonJS modules
    }, {
      loader: 'postcss-loader', // Run post css actions
      options: {
        plugins: function () { // post css plugins, can be exported to postcss.config.js
          return [
            require('precss'),
            require('autoprefixer')
          ];
        }
      }
    }, {
      loader: 'sass-loader' // compiles Sass to CSS
    }]
  },
  ...

Importing Compiled CSS

Alternatively, you may use CoreUI’s ready-to-use CSS by simply adding this line to your project’s entry point:

import 'coreui/dist/css/coreui.min.css';

In this case you may use your existing rule for css without any special modifications to webpack config, except you don’t need sass-loader just style-loader and css-loader.

  ...
  module: {
    rules: [
      {
        test: /\.css$/,
        use: ['style-loader', 'css-loader']
      }
    ]
  }
  ...