arkhamjs

Flux Framework

ArkhamJS is a lightweight framework that can accommodate a project of any size. From small start-up ideas to large enterprise projects. Our goal is to create a simple framework with flexibility. And thus came ArkhamJS.

Lightweight

The framework is small. The bulk of your app should lay within your code, not the framework. While larger frameworks come with lots of "magic", they become very limited when new features arise within your project.

Typescript

Compatible with typescript. Definitions are included to support your Typescript project.

Single Store

All data is stored within a single store. The data can be accessed through all your views and components. Data is organized into multiple stores within the single store.

Immutability

To prevent object referencing, we use immutable objects. When the state changes, the state's property is not the only item that is changed, the item it references is also updated. To prevent passing around an object between different scopes, immutable objects give your data a one way update path. You may also have returned values converted into ImmutableJS objects.

Cache

Your single store id stored in SessionStorage by default. While this can be turned off in your options, it can be very useful when saving state.

Debugger

The most important factor in choosing a framework is how easy it is to build with it. And with building comes debugging. A detailed debugger is included with the framework. When turned on, it will display any actions that come through the framework. Making the previous and new state visible to the developer. Great way to make your data transparent! Supported browsers: Chrome, Firefox, and Safari.

Skeleton

For a complete example of the setup, feel free to start your project with arkhamjs-skeleton-react. It includes a full setup of a bare bones React app using Webpack 2 and Babel 6. Also includes Karma unit testing and coverage reports.

Storage

If you plan to persist data, you will need to add a storage to the framework:

• NodeJS arkhamjs-storage-node
• React arkhamjs-storage-browser
• React Native arkhamjs-storage-native

Installation

Using npm:

$ npm install --save arkhamjs

or

$ yarn add arkhamjs

Documentation

For some detailed Documentation and additional options on the framework.