Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/city-of-helsinki/hel-bootstrap-3

City of Helsinki themed Boostrap 3 SASS library
https://github.com/city-of-helsinki/hel-bootstrap-3

bootstrap-sass theme

Last synced: about 1 month ago
JSON representation

City of Helsinki themed Boostrap 3 SASS library

Awesome Lists containing this project

README

        

# City of Helsinki Bootstrap 3 Theme

[![npm version](https://img.shields.io/npm/v/hel-bootstrap-3.svg?style=flat-square)](https://www.npmjs.com/package/hel-bootstrap-3)

City of Helsinki [Bootstrap](https://getboostrap.com) theme. **Beta**

## Contents

* Documentation - Made with [Mkdocs](http://www.mkdocs.org)
* Bootstrap sass theme - Available as npm package

## Install

Install or add Bootstrap sass theme to your application
```
npm install hel-bootstrap-3
```
NOTE: This probably [fails](https://github.com/City-of-Helsinki/hel-bootstrap-3/issues/10) on most enviroments as the sass files can not find each other or their dependencies. So importing individual files recommended for now:

## Use customised

Import the sass files in this order. Customise the theme for your application and exclude the Bootstrap components you are not using.

```
@import helsinki-variables;

@import application-variables; // Copy and edit this file to customise your app theme

@import theme-bootstrap-variables;

@import bootstrap;

@import theme-custom-styles;
```

## Files

``
_helsinki-variables.scss
``
: Helsinki UI and Brand specific variables. Do not use these directly in your app styles!

``
_application-variables.scss
``
: App specific setup. Copy and modify to customise your app's look using Helsinki brand variables or your own brand.

``
_theme-bootstrap-variables.scss
``
: Bootstrap variables with theme modifications

``
_theme-custom-styles.scss
``
: Bootstrap overrides that can not be achieved only through variables

## Bootstrap components

In your application make use of standard Bootstrap 3 components as much as possible.

More information about Bootstrap-sass [here](https://github.com/twbs/bootstrap-sass) and the use of Bootstrap components [here](http://getbootstrap.com/components/)

Compatible with [React-Bootstrap](https://react-bootstrap.github.io) components.

## Develop

* Clone this repository
* ``pip install requirements.txt``
* ``npm install``
* ``grunt dev``