nidug50 / arkhamjs Goto Github PK

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.

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.

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

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.

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.

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

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.

An app state is clears after a browser refresh. Keeping the state after a reload can be very useful when requiring a persistent state. If you plan to persist data, you will need to add a storage to the framework:

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

Using npm:

$ npm install --save arkhamjs

or

$ yarn add arkhamjs

For some detailed Documentation and additional options on the framework.