npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

use-theme-hook

v1.1.3

Published

powerfull theming hook

Downloads

97

Readme

use-theme-hook

your last theming hook

  • persist user's preferred theme
  • detect system theme
  • add your own themes

NPM JavaScript Style Guide

Install

npm install use-theme-hook
yarn add use-theme-hook

Usage

use-theme-hook comes with three hooks to save the world.

use-theme:

import useTheme from "use-theme-hook";

const example = () => {
  // useTheme returns an "internal" theme and setter that ensures that set theme exists
  const [theme, setTheme] = useTheme();

  return (
    <div>
      {/* will change theme to light*/}
      <button type="button" onClick={() => setTheme("light")}>
        light
      </button>

      {/* won't do anything, because pink theme does not exist*/}
      <button type="button" onClick={() => setTheme("pink")}>
        pink
      </button>
    </div>
  );
};

by default useTheme can return light, dark or system, and this value is persisted if changed from default.

useTheme can also take a configuration object that looks like this by default:

{
  additionalThemes = [], // [string]
  defaultClientTheme = "system", // string
  defaultStorageKey = "the_vivent_theme", //string
}

useSystemTheme

import { useSytemTheme } from "use-theme-hook";

const example2 = () => {
  // only returns 'light' or 'dark'
  // based on "prefers-color-scheme" matchMedia
  const systemTheme = useSystemTheme();

  return <div>systemTheme: {systemTheme}</div>;
};

I do NOT recommend using it, because even if you want your app to use only systemTheme, you might change your mind in future. The next hook is what I reccomend to use

useCurrentTheme

import useTheme, { useCurrentTheme } from "use-theme-hook";

const example3 = () => {
  const [theme, setTheme] = useTheme({
    additionalThemes: ["pink"],
  });

  // will output 'light' or 'dark'
  // depending on the useSystemTheme() output
  console.log(useCurrentTheme());

  setTheme("pink");
  // will output 'pink'
  console.log(useCurrentTheme());
};

useCurrentTheme internally uses both useTheme and useSystemTheme. If useTheme return 'system' useCurrentTheme will return output of useSystemTheme. Otherwise it will return useTheme output.

additional

import useTheme, { addTheme, removeTheme, listThemes } from "use-theme-hook";

const example4 = () => {
  const [theme, setTheme] = useTheme();
  const [newThemeName, setNewThemeName] = useState()
  const [delThemeName, setDelThemeName] = useState()

  const handleThemeAdd = () => {
    addTheme(newThemeName)
  }

  const handleThemeRem = () => {
    removeTheme(delThemeName)
  }

  return (
    <div>
      <select value={theme} onChange={(e) => setTheme(e.currentTarget.value)}>
        {listThemes().map((theme) => (
          <option key={theme} value={theme}>
            theme
          </option>
        ))}
      </select>

      {/*adding themes*/}
      <div>
        <input type="text" value={newThemeName} onChange={(e)=>setNewThemeName(e.currentTarget.value)}>
        <button type="button" onClick={handleThemeAdd}>
      </div>

      {/*removing themes*/}
      <div>
        <input type="text" value={newThemeName} onChange={(e)=>setDelThemeName(e.currentTarget.value)}>
        <button type="button" onClick={handleThemeRem}>
      </div>
    </div>
  );
};

listThemes return an array of all available themes
addTheme can add themes to that list

IMPORTANT

if you want to configure use-theme-hook with useTheme make sure to use useTheme with configuration before useTheme without one and before useCurrentTheme as most of the configuration cannot be changed after initialization.

defaultClientTheme - can't be changed after initialization
defaultStorageKey - can't be changed after initialization
additionalThemes - you can add other themes, but you cannot remove them

This hook supports SSR. When SSR the hook will use defaultClientTheme. If it's value is system (default) the light value will be used, but right after everything loads on the client side, it will change to what it should be.

TODO

  • code optimazation
  • tests
  • ~~removing themes~~

Changelog

1.1.3
 - fixed bug - if defaultClientTheme is not present in the themes list it is now added to it
 - added feature - removing themes with removeTheme() - you can't remove 'system', 'light' or 'dark' themes

License

MIT © TheVivent


This hook is created using create-react-hook.