@sagredoismael/redux_rn NPM

ReactNative: Agile implementation of redux with data persistence and expiration of this persistence (Android/iOS)

📖 Getting started

$ yarn add @sagredoismael/redux_rn

$ npm i @sagredoismael/redux_rn

Prerequisite if you want to use Persist data

iOS

iOS Prerequisite: Please make sure CocoaPods is installed on your system

Enter into iOS Folder cd ios/ (on your project's root folder).
Add this line to your Podfile just below the last pod (if you don't have one, you can create it by running pod init):

+ pod 'RNCAsyncStorage', :path => '../node_modules/@react-native-community/async-storage'

Run pod install

Android

Add project to android/settings.gradle:

rootProject.name = 'MyApp'

include ':app'

+ include ':@react-native-community_async-storage'
+ project(':@react-native-community_async-storage').projectDir = new File(rootProject.projectDir, '../node_modules/@react-native-community/async-storage/android')

In android/app/build.gradle add to dependencies:

dependencies {
  ...
+ implementation project(':@react-native-community_async-storage')
}

Then, in MainApplication.java:

package com.myapp;

+ import com.reactnativecommunity.asyncstorage.AsyncStoragePackage;

...

@Override
protected List<ReactPackage> getPackages() {
    return Arrays.<ReactPackage>asList(
        new MainReactPackage(),
+       ReactPackage asyncstorage = new AsyncStoragePackage();
 +         packages.add(asyncstorage);
    );
}

💻 Basic usage

import { ReduxWrapper } from '@sagredoismael/redux_rn'

const App = () => (
  <ReduxWrapper App={YouFirstComponentInApp}
  />
)

💻 With reducers usage

import { ReduxWrapper } from '@sagredoismael/redux_rn'

const exampleReducer = (state = {}, action) => {
  switch (action.type) {
      default:
          return state
  }
}

const App = () => (
  <ReduxWrapper 
   App={YouFirstComponentInApp}
   reducers= {{exampleReducer}}
  />
)

💻 Complete Usage (with persist)

import { ReduxWrapper } from '@sagredoismael/redux_rn'

const examplePersist = {
  whitelist: [
    'lastSession'
  ],
  blacklist: [],
  expired: [
    {
      name: 'lastSession',
      expireSeconds: 54000,
      expiredState: {} //initialState,
      autoExpire: true
    }
  ]
}

const exampleReducer = (state = {}, action) => {
  switch (action.type) {
      default:
          return state
  }
}

const App = () => (
  <ReduxWrapper 
   App={YouFirstComponentInApp}
   reducers= {{exampleReducer}}
   settingsPersist={examplePersist}
  />
)

💡 Props

General(iOS & Android)

Prop	Type	Mandatory	Note
`App`	`react component`	YES	Specify a react component for initialize your App
`reducers`	`object`	NO	Specify all reducers you want into combineReducers
`settingsPersist`	`object`	NO	Specify all persist config (whiteList, blackList && expired. **If you don't want time expired, is not necessary this props)