Neutral, Plus or Minus

    @bolt/settings-font-family

    0.9.0 • Public • Published

    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.


    Table of Contents

    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 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 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)1, 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 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

    2. Practical typography

    3. UI system fonts

    Install

    npm i @bolt/settings-font-family

    DownloadsWeekly Downloads

    0

    Version

    0.9.0

    License

    MIT

    Last publish

    Collaborators

    • colbycook
    • dmorse
    • mikemai2awesome
    • evanlovely
    • remydenton