https://github.com/jayphelps/nofux

Unpredictable state container for JavaScript apps.
https://github.com/jayphelps/nofux

Last synced: 21 days ago
JSON representation

Unpredictable state container for JavaScript apps.

• Host: GitHub
• URL: https://github.com/jayphelps/nofux
• Owner: jayphelps
• License: mit
• Created: 2016-05-19T00:34:15.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2021-10-06T19:17:20.000Z (about 3 years ago)
• Last Synced: 2024-09-25T21:53:19.086Z (about 1 month ago)
• Language: TypeScript
• Homepage:
• Size: 6.84 KB
• Stars: 309
• Watchers: 7
• Forks: 6
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-list - nofux

README

        
# nofux

[![Join the chat at https://gitter.im/jayphelps/nofux](https://badges.gitter.im/jayphelps/nofux.svg)](https://gitter.im/jayphelps/nofux?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![build status](https://img.shields.io/travis/reactjs/redux/master.svg)](https://travis-ci.org/jayphelps/nofux)

[![npm version](https://img.shields.io/npm/v/nofux.svg)](https://www.npmjs.com/package/nofux)

Unpredictable state container for JavaScript apps. Rethinking best practices, when you're all out of fux to give.

> "Any identifier can be globally unique, if you concatenate together enough words with dashes and underscores."

> - Mark Erikson, lead maintainer of Redux

> 

> https://twitter.com/acemarke/status/1072342186396667905?s=21

## Install

```

npm install --save nofux

```

We publish CommonJS, ES2015, ESM, and UMD builds. We also include a TypeScript definition file.

##### UMD

We publish a UMD build inside our npm package. You can use it via the [unpkg](https://unpkg.com/) CDN:

[https://unpkg.com/nofux@latest/dist/umd/nofux.min.js](https://unpkg.com/nofux@latest/dist/umd/nofux.min.js)

## Usage

> [Try reading the source code!](https://github.com/jayphelps/nofux/blob/master/src/index.ts)

The central idea of nofux is that all of your application's state is contained in a single, global atom. This state tree is held on the `nofux` namespace, which is actually an alias to the global object in your JavaScript environment, e.g. `window`.

To update the state, simply assign a property on `nofux`! That's it! ...Unless you want your app to update too, in which you need to call `this.forceUpdate()` on your component.

[JSBin Demo](http://jsbin.com/kokivar/edit?js,output)

```js

import nofux from 'nofux';

// or

const nofux = window;

class Search extends React.Component {

  render() {

    return (

      


         {

            nofux.search = event.target.value;

            this.forceUpdate();

          }}

        />

        
You have typed: {nofux.search || '(nothing yet)'}

      

    );

  }

}

```


No boilerplate, no fancy bindings or actions to dispatch. Truly global state!

## Discuss

[![Join the chat at https://gitter.im/jayphelps/nofux](https://badges.gitter.im/jayphelps/nofux.svg)](https://gitter.im/jayphelps/nofux?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

Everyone is welcome on our [Gitter channel](https://gitter.im/jayphelps/nofux?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)!

## Credit

I was inspired by this video: [https://www.youtube.com/watch?v=6wS5xOZ7Rq8](https://www.youtube.com/watch?v=6wS5xOZ7Rq8)

### Note

This is a joke...or is it?

:shipit: