Base Category Keys

base

The keys in the base category provide generic theme settings and are often referenced throughout the theme file as variables. You can think of this category as roughly analogous to the body selector in CSS. We recommended that you define this category after the page category and before all other categories.

While it’s common to define additional keys in this category (e.g., base-border-radius) to keep your theme DRY, we recommend using custom variables instead.
Key Value Type Example

border-color

Color
(default: 'EEEEEE')

base:
  border-color: #F0FFF0
yaml

border-width

Measurement
(default: 0.5)

base:
  border-width: 0.6
yaml

font-color

Color
(default: '000000')

base:
  font-color: #333333
yaml

font-family

Font family name
(default: Helvetica)

base:
  font-family: Noto Serif
yaml

font-kerning

none | normal
(default: normal)

base:
  font-kerning: none
yaml

font-size

Number
(default: 12)

base:
  font-size: 10.5
yaml

font-size-min

Number
(default: 6)

base:
  font-size-min: $base-font-size * 0.75
yaml

font-style

Font style
(default: normal)

base:
  font-style: bold
yaml

hyphens

Boolean | Language code
(default: not set)

base:
  hyphens: true
yaml

line-height

Number
(default: 1.15)

base:
  line-height: >
    $base-line-height-length /
    $base-font-size
yaml

line-height-length

Number
(default: not set)

base:
  line-height-length: 12
yaml

text-align

Text alignment
(default: left)

base:
  text-align: center
yaml

text-decoration

Text decoration
(default: none)

base:
  text-decoration: underline
yaml

text-decoration-color

Color
(default: $base-font-color)

base:
  text-decoration-color: #0000FF
yaml

text-decoration-width

Measurement
(default: 1)

base:
  text-decoration-width: 0.5
yaml

text-transform

Implicitly set to none on base.

Can’t be set on base.

line-height and line-height-length

Refer to the line-height section to learn how to use the line-height key.

The line-height-length key is a utility property that’s internal to the theme. It’s used as an intermediate property for computing the base-line-height from the base font size and the desired line height size. For instance, if you set base-line-height-length, you can use $base-line-height-length / $base-font-size to set the value of base-line-height. You don’t have to go about it this way in your own theme.

text-transform

The text-transform key can’t be set globally. Therefore, this key shouldn’t be used on the base category. The value of none is implicit and is only documented in the table above for completeness.