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

rxdux-state-manager

v1.0.5

Published

A library for managing state in react applications

Downloads

10

Readme

rxdux-state-manager

A powerful and flexible state management library developed using RxJS, inspired by the Flux architecture. Ideal for managing complex state in React applications.

Installation

Easily integrate rxdux-state-manager into your project:

npm install rxdux-state-manager

or

yarn add rxdux-state-manager

Tip: This library can be used as a React hook for efficient state management.

Getting Started with rxdux-state-manager

Initializing the State Manager

Initialize the state manager to manage your application's state effectively.

counter-state-manager.ts

import { easyStateManager } from "rxdux-state-manager";

export const {
  useStateManager: useGlobalState,
  $state: $globalState,
  updateState: updateGlobalState,
} = easyStateManager({
  count: 0,
  person: {
    name: "John Doe",
    age: 22,
  },
});

class CounterActions {
  incr = () => {
    updateGlobalState((draft) => {
      draft.count++;
    });
  };

  incrAge = () => {
    updateGlobalState((draft) => {
      draft.person.age++;
    });
  };
}

export const counterActions = new CounterActions();

Key Feature: When passing a function to the updater, the draft argument can be mutated freely. Changes will be made immutable and become the next state once the producer ends.

Using the Hook to Access and Update State

Learn how to use the hook to consume and update state in your React components.

Counter.tsx

import React from "react";
import { counterActions, useGlobalState } from "./counter-state-manager";

export default function Counter() {
  const { count } = useGlobalState("count");
  
  return (
    <div className="p-2 rounded border border-blue-500">
      <p className="text-purple-600">{count}</p>
      <button className="border p-1 rounded" onClick={counterActions.incr}>
        Increment
      </button>
    </div>
  );
}

Why Use rxdux-state-manager?

  1. Selective Rerendering: Use const { count } = useGlobalState('count') to rerender components only when specific state keys change, improving performance.
  2. Effortless State Updates: Simplify state updates with onClick={counterActions.incr} without the need for dispatchers.

Accessing Current State with RxJS BehaviorSubject

$globalState is an RxJS BehaviorSubject, allowing you to access the current state anywhere in your application:

const state = $globalState.value; 
console.log(state.person.age);

Using Multiple State Keys with useGlobalState

The useGlobalState hook can take multiple arguments for accessing various state keys:

const { count, person } = useGlobalState("count", "person");
console.log({
  count,
  person,
});

Advantages of Using rxdux-state-manager

  • Efficient State Management: Manage your application’s state efficiently with RxJS and React.
  • Scalable and Maintainable: Ideal for complex applications requiring a scalable and maintainable state management solution.
  • Improved Performance: Optimize performance with selective rerendering and immutable state updates.

License

This project is licensed under the MIT License.