How to properly introduce a light/dark mode in Bootstrap?

I use Bootstrap 4.5 and use bg-dark in my HTML template. I would like to implement a "light/dark" switch.

So, Bootstrap has a bg-light css class, but I am not sure what the current approach how to use it. Let me clarify my confusion:

  1. Am I supposed to replace all occurrences of bg-dark with bg-light once the "switch" is turned on?

  2. If I want to slightly modify the colors of bg-light and bg-dark, is "Theming" the right approach? I can’t find any examples to override these variables (via SASS), except of manually overwrite them in my CSS like .bg-dark { ... }

Thank you very much!

Stack Overflow Asked on January 5, 2022

3 Answers

3 Answers

Bootstrap 4 and 5 do not support Dark Mode. Maybe they will in Bootstrap 6.

Dark Mode is a confusing name in this context because Bootstrap does support a color, $dark: $gray-900, and, it does support several dark-tinted classes, like .bg-dark. But none of these are actual Dark Mode, which is OS-driven, passed-to-browser, website rendering switching based on:

@media (prefers-color-scheme: dark) {

Worse, things like bg-dark imply you would switch to Dark Mode by going around swapping class names out, probably via Javascript. That's a lot of CPU usage to perform a browser built-in, all because the Bootstrap authors ignored an important feature of the Web. Don't do this!

All of this is detailed in a much longer way here.

That will leave you with a lot of options, but in short for Bootstrap 4 and 5 the best, simplest, least-effort way to handle proper prefers-color-scheme: dark is to introduce an indirection into Bootstrap colors by reassigning the Bootstrap color SASS variables you're using to color CSS variables, in your _variables.scss. CSS Variables have been supported for years, are perfect for Dark Mode, and largely overlooked. For example:

:root {
    --body-bg: #fff;
    --body-color: #000;

$white: var(--body-bg);
$black: var(--body-color);
$body-color: var(--body-color);

So far all you've done is create indirection - $white still renders as #fff just like in the default Bootstrap. But now you can flip it when the OS flips:

@media (prefers-color-scheme: dark) {
    --body-bg: #000;
    --body-color: #fff;

Now when the OS gets set to Dark Mode, the browser sees it and flips that media query, and your CSS variables flip. Since you've spread those variables into the compiled Bootstrap SASS via your _variables overrides, you'll see the result in rendered Bootstrap.

I did say simplest and least-effort, but you've probably noticed this is still going to be a lot of work. Bootstrap 4 and 5 just completely missed the boat on this, so, the legwork is on you. You'll need to override every color in Bootstrap you use and introduce CSS variables for them, and you'll then need to test to find colors that aren't keyed off of any variables, and go override those with a follow-up global stylesheet.

Answered by Chris Moschini on January 5, 2022

Bootstrap 5 (update 2021)

Although there is still no definitive support for light/dark mode in Bootstrap 5, SASS can be used to create a dark theme

Bootstrap 4

Here are some answers to your question on Bootstrap light or dark mode:

"Am I supposed to replace all occurrences of bg-dark with bg-light once the "switch" is turned on?"

Yes, but you'd probably also want to switch all -light and -dark classes such as text-dark, navbar-dark, btn-dark, etc..

If I want to slightly modify the colors of bg-light and bg-dark.. I can't find any examples to override these variables (via SASS), except of manually overwrite them in my CSS like .bg-dark...

These are derived from $light and $dark SASS variables so you can change them like this...

$light: #dddddd;
$dark: #011100;

@import "bootstrap";

Demo Bootstrap Light Dark Mode Switch

Also see:
Customizing Bootstrap CSS template
How to extend/modify (customize) Bootstrap 4 with SASS

Answered by Zim on January 5, 2022

Check this:

"Customize Bootstrap 4 with our new built-in Sass variables for global style preferences for easy theming and component changes."

Once you want apply the changes by Sass this looks like be the right path

And by their documentation the variables for change this is on "scss/_variables.scss" file

Here is another topic with some additional info how to achieve this: Customizing Bootstrap CSS template

Answered by Guilherme Mascarenhas on January 5, 2022

Add your own answers!

Related Questions

Why does points.sort(function(a, b){return a-b}); return -1, 0 or 1?

6  Asked on November 4, 2021 by camarellini-viberg


To add new row in gridview using javascript

2  Asked on November 4, 2021


python extract uncompressed data from 7z-file

2  Asked on November 4, 2021 by user3820991


JMeter get the latest file / contents from SFTP folder

1  Asked on November 4, 2021 by javaman


Pulling Data automatically, and keeping it Dynamic

1  Asked on November 4, 2021 by andrew-ferro


Dynamically consolidate columns into one column with a list of values

2  Asked on November 4, 2021 by simon-watson-sjw


Validity unknown symbol is not being displayed on PDF

1  Asked on November 4, 2021 by divya-agrawal


Use type that isn’t exported

1  Asked on November 4, 2021


how to return 0 if no rows

4  Asked on November 4, 2021


error installing laravel via composer on new pc

1  Asked on November 4, 2021 by hretic


The Data Flows Down in React.js

2  Asked on November 4, 2021 by fahd-dev


Ask a Question

Get help from others!

© 2022 All rights reserved.