Skip to main content

Customize

Color

felt-css keeps Bootstrap's colour meanings and dyes them like wool: denim, taupe, moss, tomato, mustard and petrol. Every colour is a custom property you can re-dye.

View page source on GitHub

Theme colors#

Like Bootstrap, felt-css has eight theme colours with the usual meanings. Their tones are chosen to look good as felt and work flat too.

Primary · denim
Secondary · taupe
Success · moss
Danger · tomato
Warning · mustard
Info · petrol
Light
Dark
<div class="row row-cols-2 row-cols-md-4 g-3">
  <div class="col"><div class="p-3 rounded text-bg-primary">Primary · denim</div></div>
  <div class="col"><div class="p-3 rounded text-bg-secondary">Secondary · taupe</div></div>
  <div class="col"><div class="p-3 rounded text-bg-success">Success · moss</div></div>
  <div class="col"><div class="p-3 rounded text-bg-danger">Danger · tomato</div></div>
  <div class="col"><div class="p-3 rounded text-bg-warning">Warning · mustard</div></div>
  <div class="col"><div class="p-3 rounded text-bg-info">Info · petrol</div></div>
  <div class="col"><div class="p-3 rounded text-bg-light">Light</div></div>
  <div class="col"><div class="p-3 rounded text-bg-dark">Dark</div></div>
</div>

Each colour comes as a small family of tokens, Bootstrap's *-bg-subtle, *-border-subtle and *-text-emphasis included:

TokenUseClasses that use it
--felt-primaryThe fill: buttons, badges, progress bars, active items.btn-primary, .bg-primary, .text-bg-primary
--felt-primary-inkText on the fill, at least 4.5:1.text-bg-primary, .btn-primary
--felt-primary-subtleA tint of the fill on the current surface.bg-primary-subtle, .alert-primary
--felt-primary-border-subtleA border on that tint.border-primary-subtle
--felt-primary-emphasisText on the tint, at least 4.5:1.text-primary-emphasis, .alert-primary
--felt-primary-textColoured text directly on the page.text-primary, .link-primary

The same tokens exist for secondary, success, danger, warning, info, light and dark (light and dark have no -text). All of them, with their values in both looks:

TokenValueBootstrapUsed for
--felt-primarylight-dark(var(--felt-denim), #385c93)--bs-primaryPrimary fill
--felt-primary-ink#fffText and icons on the primary fill
--felt-secondarylight-dark(var(--felt-taupe), #6a5f52)
felt light-dark(#716558, #6a5f52)
--bs-secondarySecondary fill
--felt-secondary-ink#fffText and icons on the secondary fill
--felt-successlight-dark(var(--felt-moss), #527530)
felt light-dark(#4e7225, #4f712c)
--bs-successSuccess fill
--felt-success-ink#fffText and icons on the success fill
--felt-dangerlight-dark(var(--felt-tomato), #b23f29)
felt light-dark(#be3f29, #b23f29)
--bs-dangerDanger fill
--felt-danger-ink#fffText and icons on the danger fill
--felt-warninglight-dark(var(--felt-mustard), #cf9520)--bs-warningWarning fill
--felt-warning-ink#3a2a06Text and icons on the warning fill
--felt-infolight-dark(var(--felt-petrol), #276f75)
felt light-dark(#227379, #276f75)
--bs-infoInfo fill
--felt-info-ink#fffText and icons on the info fill
--felt-lightlight-dark(#f8f9fa, #3b4148)
felt light-dark(#f3ece0, #4a443d)
--bs-lightLight fill
--felt-light-inklight-dark(#1f2633, #e9ecef)
felt light-dark(var(--felt-navy), #efe7da)
Text and icons on the light fill
--felt-darklight-dark(#212529, #111315)
felt light-dark(var(--felt-navy), #202840)
--bs-darkDark fill
--felt-dark-ink#f8f9faText and icons on the dark fill
--felt-primary-emphasislight-dark(#26406a, #a9c4ee)--bs-primary-text-emphasisText on primary tints (.alert-primary, .text-primary-emphasis), 4.5:1 or more
--felt-secondary-emphasislight-dark(#4a4136, #d6cdbf)--bs-secondary-text-emphasisText on secondary tints (.alert-secondary, .text-secondary-emphasis), 4.5:1 or more
--felt-success-emphasislight-dark(#36501d, #b0d18c)
felt light-dark(#324c19, #b0d18c)
--bs-success-text-emphasisText on success tints (.alert-success, .text-success-emphasis), 4.5:1 or more
--felt-danger-emphasislight-dark(#7d2a1b, #f3a593)--bs-danger-text-emphasisText on danger tints (.alert-danger, .text-danger-emphasis), 4.5:1 or more
--felt-warning-emphasislight-dark(#6b4e12, #f1cb72)
felt light-dark(#5c4000, #f1cb72)
--bs-warning-text-emphasisText on warning tints (.alert-warning, .text-warning-emphasis), 4.5:1 or more
--felt-info-emphasislight-dark(#1b4f53, #94d3d6)
felt light-dark(#174c50, #94d3d6)
--bs-info-text-emphasisText on info tints (.alert-info, .text-info-emphasis), 4.5:1 or more
--felt-light-emphasislight-dark(#495057, #dee2e6)
felt light-dark(#3f464d, #dee2e6)
--bs-light-text-emphasisText on light tints (.alert-light, .text-light-emphasis), 4.5:1 or more
--felt-dark-emphasislight-dark(#343a40, #adb5bd)--bs-dark-text-emphasisText on dark tints (.alert-dark, .text-dark-emphasis), 4.5:1 or more
--felt-primary-textlight-dark(var(--felt-primary), #8fb2e8)
felt var(--felt-link-color)
Primary as text on the page (.text-primary, .link-primary)
--felt-secondary-textlight-dark(var(--felt-secondary), #c4b9aa)
felt light-dark(#584e43, #c4b9aa)
Secondary as text on the page (.text-secondary, .link-secondary)
--felt-success-textlight-dark(#4e6f2c, #98c26c)
felt light-dark(#3b581e, #98c26c)
Success as text on the page (.text-success, .link-success)
--felt-danger-textlight-dark(var(--felt-danger), #ef8c76)
felt light-dark(#932b16, #ef8c76)
Danger as text on the page (.text-danger, .link-danger)
--felt-warning-textlight-dark(#8a5f0c, var(--felt-warning))
felt light-dark(#6d4900, var(--felt-warning))
Warning as text on the page (.text-warning, .link-warning)
--felt-info-textlight-dark(var(--felt-info), #6cc3c8)
felt light-dark(#0f585d, #6cc3c8)
Info as text on the page (.text-info, .link-info)
--felt-light-fixed#f8f9fa
felt #f3ece0
Light that keeps its tone in dark mode, like Bootstrap's (.bg-light, .text-light)
--felt-dark-fixed#212529
felt var(--felt-navy)
Dark that keeps its tone in dark mode (.bg-dark, .text-dark)
--felt-primary-subtlecolor-mix(in oklab, var(--felt-primary) 14%, var(--felt-surface))--bs-primary-bg-subtlePrimary tint (.bg-primary-subtle, .alert-primary)
--felt-secondary-subtlecolor-mix(in oklab, var(--felt-secondary) 14%, var(--felt-surface))--bs-secondary-bg-subtleSecondary tint (.bg-secondary-subtle, .alert-secondary)
--felt-success-subtlecolor-mix(in oklab, var(--felt-success) 14%, var(--felt-surface))--bs-success-bg-subtleSuccess tint (.bg-success-subtle, .alert-success)
--felt-danger-subtlecolor-mix(in oklab, var(--felt-danger) 14%, var(--felt-surface))--bs-danger-bg-subtleDanger tint (.bg-danger-subtle, .alert-danger)
--felt-warning-subtlecolor-mix(in oklab, var(--felt-warning) 18%, var(--felt-surface))--bs-warning-bg-subtleWarning tint (.bg-warning-subtle, .alert-warning)
--felt-info-subtlecolor-mix(in oklab, var(--felt-info) 14%, var(--felt-surface))--bs-info-bg-subtleInfo tint (.bg-info-subtle, .alert-info)
--felt-light-subtlecolor-mix(in oklab, var(--felt-light) 50%, var(--felt-surface))--bs-light-bg-subtleLight tint (.bg-light-subtle, .alert-light)
--felt-dark-subtlecolor-mix(in oklab, var(--felt-dark) 20%, var(--felt-surface))
felt color-mix(in oklab, var(--felt-secondary) 18%, var(--felt-surface))
--bs-dark-bg-subtleDark tint (.bg-dark-subtle, .alert-dark)
--felt-primary-border-subtlecolor-mix(in oklab, var(--felt-primary) 32%, var(--felt-surface))--bs-primary-border-subtleBorder of primary tints
--felt-secondary-border-subtlecolor-mix(in oklab, var(--felt-secondary) 32%, var(--felt-surface))--bs-secondary-border-subtleBorder of secondary tints
--felt-success-border-subtlecolor-mix(in oklab, var(--felt-success) 32%, var(--felt-surface))--bs-success-border-subtleBorder of success tints
--felt-danger-border-subtlecolor-mix(in oklab, var(--felt-danger) 32%, var(--felt-surface))--bs-danger-border-subtleBorder of danger tints
--felt-warning-border-subtlecolor-mix(in oklab, var(--felt-warning) 40%, var(--felt-surface))--bs-warning-border-subtleBorder of warning tints
--felt-info-border-subtlecolor-mix(in oklab, var(--felt-info) 32%, var(--felt-surface))--bs-info-border-subtleBorder of info tints
--felt-light-border-subtlevar(--felt-border-color)--bs-light-border-subtleBorder of light tints
--felt-dark-border-subtlecolor-mix(in oklab, var(--felt-dark) 40%, var(--felt-surface))--bs-dark-border-subtleBorder of dark tints

Palette#

The theme colours point at a small palette of wool dyes. Bootstrap's named colours have a felt counterpart each (blue is denim, red tomato …):

--felt-denim
--felt-taupe
--felt-moss
--felt-tomato
--felt-mustard
--felt-petrol
--felt-navy
--felt-indigo
--felt-plum
--felt-rose
--felt-pumpkin
--felt-lagoon
<div class="row row-cols-2 row-cols-md-4 g-3 small">
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-denim)">--felt-denim</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-taupe)">--felt-taupe</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-moss)">--felt-moss</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-tomato)">--felt-tomato</div></div>
  <div class="col"><div class="p-3 rounded" style="background: var(--felt-mustard); color: #3a2a06">--felt-mustard</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-petrol)">--felt-petrol</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-navy)">--felt-navy</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-indigo)">--felt-indigo</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-plum)">--felt-plum</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-rose)">--felt-rose</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-pumpkin)">--felt-pumpkin</div></div>
  <div class="col"><div class="p-3 rounded text-white" style="background: var(--felt-lagoon)">--felt-lagoon</div></div>
</div>
TokenValueBootstrapUsed for
--felt-mustard#e0a224--bs-yellowWarning
--felt-denim#3d64a0--bs-bluePrimary
--felt-moss#5a7f33--bs-greenSuccess
--felt-tomato#c4452f--bs-redDanger
--felt-petrol#2b7a80--bs-tealInfo
--felt-taupe#7a6e60Secondary
--felt-navy#1e2b45Ink of the felt look
--felt-indigo#4b4f9c--bs-indigoIndigo felt
--felt-plum#7b4a82--bs-purplePurple felt
--felt-rose#c45a78--bs-pinkPink felt
--felt-pumpkin#d6772e--bs-orangeOrange felt
--felt-lagoon#3a9bb2--bs-cyanCyan felt
--felt-black#000--bs-blackBlack
--felt-white#fff--bs-whiteWhite

Grays#

A gray scale from 100 to 900 that, like Bootstrap's, doesn't follow the colour mode. In the clean look it is Bootstrap's grays; in the felt look warm grays from cream to charcoal, so a gray piece still looks like wool.

100
200
300
400
500
600
700
800
900
<div class="d-flex flex-wrap gap-2 small">
  <div class="p-3 rounded" style="background: var(--felt-gray-100)">100</div>
  <div class="p-3 rounded" style="background: var(--felt-gray-200)">200</div>
  <div class="p-3 rounded" style="background: var(--felt-gray-300)">300</div>
  <div class="p-3 rounded" style="background: var(--felt-gray-400)">400</div>
  <div class="p-3 rounded" style="background: var(--felt-gray-500)">500</div>
  <div class="p-3 rounded text-white" style="background: var(--felt-gray-600)">600</div>
  <div class="p-3 rounded text-white" style="background: var(--felt-gray-700)">700</div>
  <div class="p-3 rounded text-white" style="background: var(--felt-gray-800)">800</div>
  <div class="p-3 rounded text-white" style="background: var(--felt-gray-900)">900</div>
</div>
TokenValueBootstrapUsed for
--felt-gray-100#f8f9fa
felt #f5efe5
--bs-gray-100Gray 100
--felt-gray-200#e9ecef
felt #e9e1d3
--bs-gray-200Gray 200
--felt-gray-300#dee2e6
felt #d9cfbe
--bs-gray-300Gray 300
--felt-gray-400#ced4da
felt #bcb09c
--bs-gray-400Gray 400
--felt-gray-500#adb5bd
felt #9b8f7c
--bs-gray-500Gray 500
--felt-gray-600#6c757d
felt #7a6e60
--bs-gray
--bs-gray-600
Gray 600
--felt-gray-700#495057
felt #5e554a
--bs-gray-700Gray 700
--felt-gray-800#343a40
felt #433d36
--bs-gray-800
--bs-gray-dark
Gray 800
--felt-gray-900#212529
felt #2b2723
--bs-gray-900Gray 900

Light and dark#

Theme tokens are written as light-dark(light, dark). Dark mode mutes the fills a little, so they glare less and white ink stays readable:

:root {
  --felt-primary: light-dark(var(--felt-denim), #385c93);
  --felt-primary-ink: #fff;
  --felt-primary-emphasis: light-dark(#26406a, #a9c4ee);
}

Tints (*-subtle, *-border-subtle) are mixed from the fill and the current surface with color-mix(), so they follow the theme without a second value.

Re-dyeing#

To change a colour, override its tokens in your own stylesheet. There's no build step: the whole sheet — buttons, alerts, focus rings, the felt patches — takes the new dye.

:root {
  --felt-primary: light-dark(#7a3d8f, #6c3780);       /* heather instead of denim */
  --felt-primary-ink: #fff;
  --felt-primary-emphasis: light-dark(#4d2259, #dcb5e8);
  --felt-primary-text: light-dark(#7a3d8f, #cfa2df);
  --felt-link-color: light-dark(var(--felt-primary), #cfa2df);
}

Keep *-ink and *-emphasis readable when you change a fill: felt-css aims for at least 4.5:1 contrast for text on fills and on tints, in both modes.

Surfaces and text#

Neutral colours are tokens too. See CSS variables for the full list.

--felt-body-bg page
--felt-surface cards, fields
--felt-surface-sunk wells, code
--felt-surface-raised raised
--felt-surface-overlay menus, modals
--felt-field inputs
<div class="row row-cols-1 row-cols-md-3 g-3 small">
  <div class="col"><div class="p-3 rounded border" style="background: var(--felt-body-bg)"><code>--felt-body-bg</code> page</div></div>
  <div class="col"><div class="p-3 rounded border" style="background: var(--felt-surface)"><code>--felt-surface</code> cards, fields</div></div>
  <div class="col"><div class="p-3 rounded border" style="background: var(--felt-surface-sunk)"><code>--felt-surface-sunk</code> wells, code</div></div>
  <div class="col"><div class="p-3 rounded border" style="background: var(--felt-surface-raised)"><code>--felt-surface-raised</code> raised</div></div>
  <div class="col"><div class="p-3 rounded border" style="background: var(--felt-surface-overlay)"><code>--felt-surface-overlay</code> menus, modals</div></div>
  <div class="col"><div class="p-3 rounded border" style="background: var(--felt-field)"><code>--felt-field</code> inputs</div></div>
</div>