# bolt/settings-font-family

Font family settings based on Pega branding and accessibility. Part of the Bolt “Core” CSS framework that powers the [Bolt Design System](https://www.boltdesignsystem.com).

- [Sassdocs](https://www.boltdesignsystem.com/docs/#settings:%20typography-variable-font-family)
- Demo (Coming Soon)

---

## Table of Contents

- [Cheat Sheet](#cheat-sheet)
- [Getting Started](#getting-started)
- [Font Family Features](#font-family-features)
- [Further Reading](#further-reading)

## Cheat Sheet

### Install via NPM

```
npm install @bolt/settings-font-family
```

### Font Family Chart

#### Brand Fonts

|   Font    |   Category   |
| :-------: | :----------: |
| Open Sans | Heading text |
| Open Sans |  Body text   |

#### Fallback Fonts

|     Font      |           Device            |
| :-----------: | :-------------------------: |
| San Francisco |      Mac OS X and iOS       |
|   Segoe UI    |  Windows and Windows Phone  |
|    Roboto     | Android and newer Chrome OS |
|    Oxygen     |             KDE             |
|    Ubuntu     |           Ubuntu            |
|   Cantarell   |            GNOME            |
|   Fira Sans   |         Firefox OS          |
|  Droid Sans   |  Older versions of Android  |

---

## Getting Started

The best way to start using Bolt is via the _Bolt Starterkit_ (coming soon), a pre-assembled front-end boilerplate designed to get you up and running as quickly as possible.

You can also use the full [Bolt Core](https://www.npmjs.com/package/@bolt/core) CSS framework on its own, or, install just the parts you need and fold the different ITCSS layers of Bolt into your existing codebase.

Installing Bolt’s font-family settings is as easy as running NPM install:

```
npm install @bolt/settings-font-family
```

> **TIP:**: Don’t have a `package.json` file? Need a little help getting started? Check out our [Getting Started](https://www.boltdesignsystem.com/getting-started) guide for some tips to help get you up to speed.

### Usage

Once installed, you should `@import` the main Sass partial into your project’s main `.scss` file to make the included variables available to the rest of your code.

```
// Settings
@import ‘@bolt/settings-font-family’
...

// Tools
@import ‘@bolt/tools-...’
```

Since Bolt's CSS architecture is based on [ITCSS (Inverted Triangle CSS)](http://www.creativebloq.com/web-design/manage-large-css-projects-itcss-101517528)<sup>[1](#1-learn-more-about-itcss)</sup>, what Sass partials you import, and in what order, makes a whole world of difference. That’s why importing any Settings packages from Bolt in your project’s Settings layer (prior to any Sass mixins, resets, base HTML element styles, etc) is so important.

### Compiling

We recommend using Bolt’s Gulp-based [front-end build tools](https://www.npmjs.com/package/@bolt/build-tools) to compile your Sass as we're pre-packaging many of the latest tools and add-ons to help you write your very best: LibSass, Autoprefixer, PostCSS, CleanCSS, Sassdoc, Stylelint, Gulp Plumber, npm-sass, and BrowserSync live reloading.

---

## Font Family Features

The _Bolt Design System_ team has gone through vigorous testing to make sure all fonts are accessible on all devices.

### Fallback Option for UI System Fonts

Bolt’s font family is defined with a fallback option. When the branded Open Sans is not available to the user, device specific UI System Fonts will be used instead to display all types.

## Further Reading:

### 1. Learn more about ITCSS

- [Harry Roberts - Managing CSS Projects with ITCSS - YouTube](https://www.youtube.com/watch?v=1OKZOV-iLj4)
- [ITCSS: Scalable and Maintainable CSS Architecture - Xfive](https://www.xfive.co/blog/itcss-scalable-maintainable-css-architecture/)
- [Manage large CSS projects with ITCSS | Creative Bloq](http://www.creativebloq.com/web-design/manage-large-css-projects-itcss-101517528)
- [How I Shrank my CSS by 84kb by Refactoring with ITCSS](https://medium.com/@jordankoschei/how-i-shrank-my-css-by-84kb-by-refactoring-with-itcss-2e8dafee123a)

### 2. Practical typography

- [Butterick’s Practical Typography](http://practicaltypography.com/)

### 3. UI system fonts

- [Using UI System Fonts In Web Design: A Quick Practical Guide | Smashing Magazine](https://www.smashingmagazine.com/2015/11/using-system-ui-fonts-practical-guide/)
- [Implementing system fonts on Booking.com — A lesson learned. | Booking.design](https://booking.design/implementing-system-fonts-on-booking-com-a-lesson-learned-bdc984df627f)
- [System shock – Designing Medium | Medium](https://medium.design/system-shock-6b1dc6d6596f)