Getting Started

Introduction

Hello, I hope you find this template useful. Spark 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 Spark'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. Spark 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
Theming

To customize the theme, pick one of the themes below and add the className to the body element.

<body class="theme-blue">
  ...
</body>
<body class="theme-indigo">
  ...
</body>
<body class="theme-purple">
  ...
</body>
<body class="theme-pink">
  ...
</body>
<body class="theme-red">
  ...
</body>
<body class="theme-orange">
  ...
</body>
<body class="theme-yellow">
  ...
</body>
<body class="theme-green">
  ...
</body>
<body class="theme-teal">
  ...
</body>
<body class="theme-cyan">
  ...
</body>
Changelog

v3.1.0

– 23 March, 2019
  • Added multiple color schemes
  • Added calendar page (calendar.html)
  • Added tasks page (pages-tasks.html)
  • Added card actions
  • Added new sidebar
  • Swapped font with Nunito Sans
  • Removed box shadows
  • Removed deprecated morris.js library
  • Removed deprecated raphael library
  • Restructured sass files
  • Upgraded to Bootstrap 4.3.1
  • Upgraded various dependencies to LTS version

v3.0.1

– 6 January, 2019
  • Added Bootstrap spinners (ui-general.html)
  • Added Bootstrap switches (forms-basic-elements.html)
  • Moved from webpack-serve to webpack-dev-server
  • Upgraded to Bootstrap 4.2.1
  • Upgraded various dependencies to LTS version

v3.0.0

– 17 November, 2018
  • Re-created from scratch
  • New components and page designs
  • Optimized for speed and usability
  • Fully W3C-valid
  • Updated to Bootstrap 4.1.3
Contents

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/
  ├── .babelrc
  ├── .gitignore
  ├── package.json
  ├── postcss.config.js
  ├── webpack.config.js
  ├── README.md
  ├── docs/
  ├── src/
  │   ├── css/
  │   │   ├── mixins/
  │   │   ├── utilities/
  │   │   └── app.scss
  │   ├── js/
  │   │   ├── modules/
  │   │   ├── vendor/
  │   │   └── app.js
  │   │── fonts/
  │   └── img/
  └── dist/
      ├── css/
      │   └── app.css
      ├── js/
      │   └── app.js
      ├── img/
      └── fonts/
Basic Template

This basic template can be used as a guideline for how to structure new pages while using Spark. 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>Spark</title>

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

  <script src="{PATH}/dist/js/app.js"></script>
</body>
</html>