Skip to content

Billmate/billmate-style-library

Repository files navigation

Billmate style library

A frontend styling library for using Billmate styles. It is built upon the CSS framework called Bulma and contains the icon library Font Awesome.

So basically any component or styling from Bulma documentation can be used but with a Billmate look and feel.

Usage in projects

To use this library inside other projects you can use both the SASS or CSS files. Add the package into a npm based project. Add the following to package.json:

"billmate-style-library": "git+https://<GITHUB_TOKEN>@github.com/Billmate/billmate-style-library.git#<VERSION>"

CSS

To use the CSS file.

@import '~billmate-style-library/css/styles.css';

To use the minified CSS file.

@import '~billmate-style-library/css/styles.min.css';

SASS

To use the SASS file and the framework.

@import '~billmate-style-library/sass/styles.scss';

Then there is a need to override the SASS variable with the correct path.

$billmate-resource-path: '~billmate-style-library';

Installation

To being able to work and test this repo the following steps needs to be done.

npm install

For development just use the command

npm start (same as npm run css:watch)

Commands

CSS

The following commands are available for CSS and SASS.

Building

npm run css:build

Builds the CSS files for Production.

Building minified

npm run css:build:minified

Builds the CSS files for Production as minified.

Building all

npm run css:prod

Builds all the necessary CSS files at once.

Watching

npm run css:watch

Builds the CSS and watches for changes.

Linting

npm run css:lint

Lints the CSS.

Resources

npm run css:resources

Moves and adds the correct resources for CSS/SASS to use.

Styleguide

The following commands are available for Styleguide. When being compiled it ends up in the folder called docs. To access it for local development the url is:

locahost:3000

Building

npm run styleguide:build

Builds the Styleguide files for Production.

Watching

npm run styleguide:watch

Builds the Styleguide and watches for changes.