Robust UI Kit

Introduction

Hello, I hope you find this template useful. Robust UI Kit has been crafted on top of Bootstrap 4. The included docs don't replace the official ones, but provide a clear view of all extended styles and new components that this template provides on top of Bootstrap 4.

The docs includes information to understand how the theme is organized, how to make changes to the source code, and how to compile and extend it to fit your needs.

Thanks, and good luck!

Quick start

The theme includes a custom Webpack file, which can be used to quickly recompile and minify theme assets while developing or for deployment. You'll need to install Node.js before using Webpack.

Once Node.js is installed, run npm install to install the rest of Robust's dependencies. All dependencies will be downloaded to the node_modules directory.

npm install

Now you're ready to modify the source files and generate new dist/ files. Robust is using webpack and webpack-dev-server to automatically detect file changes and start a local webserver at http://localhost:8080.

npm start

Build tools

Start a local webserver at http://localhost:8080 and detect file changes:

npm start

Automatically detect file changes without starting a local webserver:

npm run watch

Compile, optimize, minify and uglify all source files to dist/:

npm run build

Inside the zip-file you'll find the following directories and files. Both compiled and minified distrubution files, as well as the source files are included in the package.

theme/
  ├── package.json
  ├── README.md
  ├── docs/
  ├── config/
  │   ├── common.config.js
  │   ├── build.config.js
  │   ├── dev.config.js
  ├── src/
  │   ├── css/
  │   │   ├── 1-variables/
  │   │   ├── 2-mixins/
  │   │   ├── 3-components/
  │   │   ├── 4-utilities/
  │   │   └── robust.scss
  │   ├── js/
  │   │   └── main.js
  │   └── fonts/
  └── dist/
      ├── css/
      │   ├── app.css
      │   └── app.css.map
      ├── js/
      │   ├── app.js
      │   └── app.js.map
      └── fonts/

Basic Template

This basic template can be used as a guideline for how to structure new pages while using Robust. Some meta tags and our CSS & JS files are included inside the template.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
  <meta name="description" content="">
  <meta name="author" content="">

  <title>Robust UI Kit</title>

  <!-- Robust CSS file -->
  <link href="{PATH}/css/app.css" rel="stylesheet">
</head>
<body>
  <h1>Hello, world!</h1>

  <!-- Robust JS file -->
  <script src="{PATH}/js/app.js"></script>
</body>
</html>