A Sass & Stylus Type Toolkit

Download Latest View on GitHub Example Code

A Sass and Stylus Toolkit for Setting Type

Set your type in Ems with modular scale, vertical rhythm, and responsive ratio based headlines using Sass or Stylus. Why create another type toolkit? I wanted to and I couldn’t find exactly what I was looking for. Typesettings uses techniques from many different amazing tools while trying to keep it simple.

  • Its only dependency is Sass or Stylus
  • It uses Ems for type not REMs or pixels
  • It handles all the math for Ems including the compounding
  • It maintains vertical rhythm with pixel based borders using padding set in Ems
  • It comes with a default 6px baseline to maintain rhythm on all block elements
  • It relies more on using functions combined with vanilla CSS rules rather than mixins to style
  • It uses modular scale values to set font-size
  • It has optional default type styles that includes settings for adjusting headlines based on screen width

How to setup

You can either use the Sass versison or the Stylus version. There are three ways you can download both versions of Typesettings.

Setup Sass

To start using Typesettings @import the _typesettings.scss partial into your Sass project after your CSS reset.

Setup Stylus

To start using Typesettings @import the _typesettings.styl partial into your Stylus project after your CSS reset.

How to use

After Typesettings is setup in your project the default type styles should be looking good. However I bet you want to use modular scale and vertical rhythm in the rest of your project. Here is an example of how to do that:

The SCSS:

The Stylus:

The generated CSS:

You can also look at the source code of this site to see how it was made using Typesettings.

Requirements

Sass or Stylus, that’s it.

Functions

Internally Typesettings uses some utility functions, which if you have a need use them. It also contains functions that can and should be used for setting type. Typesettings will warn you if a value will not result in a rhythm friendly value. If you would like to silence the warning you can pass the argument $silent: true.

The Sass function emRhythm returns an EM value that is a multiple of our defined base vertical unit. For example 3 becomes 1.125em

The Sass function unitlessRhythm returns a unitless number that is a multiple of our defined base vertical unit. For example 3 becomes 1.125

Mixins

Typesettings provides a number of helpful typesetting and vertical spacing mixins. Typesettings will warn you if a value will not result in a rhythm friendly value. If you would like to “silent” the warning you can pass the argument $silent: true

The mixin setType sets the type in EMs and makes a vertical rhythm unitless line-height that is based on context.

The mixin setLeading creates a vertical rhythm unitless line-height that is based on context.

The mixin rhythmBorderTop creates a pixel width border top with padding that is a multiple of the base vertical grid unit. You will need to set border style and color rules.

The mixin rhythmBorderBottom creates a pixel width border bottom with padding that is a multiple of the base vertical grid unit. You will need to set border style and color rules.

The mixin rhythmBorder creates a pixel width border with padding that is a multiple of the base vertical grid unit. You will need to set border style and color rules

The mixin debug-vertical-alignment creates base type baseline overlay and vertical unit overlay. To use on the body tag for example: body { @include debug-vertical-alignment(); } and add class va-debug to the body tag

Precision

Typesettings uses relative units and many of the values outputted are a result of dividing and multiplying. So a computed pixel value like 17.999999px will sometimes happen.

Thanks and Resources

License

The MIT License (MIT)

Back to Top