gatsby-theme-ghost-dark-mode

Gatsby theme to integrate dark mode into gatsby-theme-try-ghost.

Usage no npm install needed!

<script type="module">
  import gatsbyThemeGhostDarkMode from 'https://cdn.skypack.dev/gatsby-theme-ghost-dark-mode';
</script>

README

gatsby-theme-ghost-dark-mode

Released under MIT license. gatsby-theme-ghost-dark-mode npm package version. PRs welcome!

Integrates dark mode into gatsby-theme-try-ghost. This theme makes use of latent-component-shadowing and showcases best practices for adding custom themes to gatsby-theme-try-ghost.

Install

yarn add gatsby-theme-ghost-dark-mode

Dependencies

This theme is an add-on theme designed to seamlessly integrate with gatsby-theme-try-ghost. The theme uses functions provided by gatsby-theme-try-ghost, so installing gatsby-theme-try-ghost is required.

yarn add gatsby-theme-try-ghost

How to use

// In your gatsby-config.js
plugins: [
    {
        resolve: `gatsby-theme-ghost-dark-mode`,
        options: {
            // Set to true if you want your theme to default to dark mode (default: false)
            // Note that this setting has an effect only, if
            //    1. The user has not changed the dark mode
            //    2. Dark mode is not reported from OS
            defaultModeDark: false,
            // If you want the defaultModeDark setting to take precedence
            // over the mode reported from OS, set this to true (default: false)
            // Note that user choice still takes precedence over this setting
            overrideOS: false,
        },
    },
]

Details

This Gatsby theme plugin hooks into the gatsby-theme-try-ghost theme and adds a dark mode toggle in the top right navigation bar. User's dark mode settings are persisted to localStore, so they should remain on page revisits. If the functionality is provided by the browser, dark mode setting is read from the OS and that setting is taken for first time use. The defaultModeDark setting is taken, if OS does not report dark mode or if the user has not chosen a theme preference in the OS. Finally, OS settings can be overruled with overrideOS.

This plugin also shows how to best customize gatsby-theme-try-ghost. The latent-component-shadowing approach used here is very general and is an amazing concept. This is useful if you plan on customizing gatsby-theme-try-ghost yourself.

Limitations

If you use PrismJS your prism styles might be changed. Currently, the best option is to use a dark PrismJS style that looks great in both dark and light mode.

Contributions

PRs are welcome! Consider contributing to this project if you are missing feature that is also useful for others. Explore this guide, to get some more ideas.

Copyright & License

Copyright (c) 2020 styxlab - Released under the MIT license.