Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@react-hooks-hub/use-dark-mode

Keized430MIT1.0.0TypeScript support: included

A React hook to manage dark mode and light mode with persistence.

react, react-hook, react hook, hook, react dark mode, dark mode hook, react theme, dark mode

readme

Use Dark Mode

`@react-hooks-hub/use-dark-mode`

NPM version CI status   Coverage   Bundlephobia  

@react-hooks-hub/use-dark-mode

use-dark-mode is a custom React hook that allows you to easily manage dark mode in your application. It simplifies the handling of user preferences regarding the theme (light or dark) with support for the system default mode. This hook is configurable and can be persisted in localStorage to remember the user's choices between sessions.

Features

  • Automatic Dark Mode: Based on the user's system preferences.
  • Persistence: Saves the user's chosen theme in localStorage.
  • Simple Configuration: Customize the storage key and default mode.
  • Easy Integration: Simple to use in any React application.

Installation

Use your preferred package manager to install @react-hooks-hub/use-dark-mode:

npm install @react-hooks-hub/use-dark-mode
# or
yarn add @react-hooks-hub/use-dark-mode

Usage

Import and use the useDarkMode hook in your component:

import React from 'react';
import { useDarkMode } from '@react-hooks-hub/use-dark-mode';

function MyComponent() {
  const { switchMode, darkMode } = useDarkMode({ persistance: true, defaultMode: 'system' });

  return (
    <div style={{ background: darkMode ? '#333' : '#fff', color: darkMode ? '#fff' : '#000' }}>
      <h1>{darkMode ? 'Dark Mode' : 'Light Mode'}</h1>
      <button onClick={() => switchMode('light')}>Light</button>
      <button onClick={() => switchMode('dark')}>Dark</button>
      <button onClick={() => switchMode('system')}>System</button>
    </div>
  );
};

export default MyComponent;