https://github.com/mapp-digital/mapp-fashion-reactnative-plugin-expo
https://github.com/mapp-digital/mapp-fashion-reactnative-plugin-expo
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/mapp-digital/mapp-fashion-reactnative-plugin-expo
- Owner: mapp-digital
- License: mit
- Created: 2025-06-25T15:55:46.000Z (12 months ago)
- Default Branch: master
- Last Pushed: 2025-07-02T13:52:21.000Z (12 months ago)
- Last Synced: 2025-08-12T00:52:17.095Z (10 months ago)
- Language: TypeScript
- Size: 119 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Dressipi SDK Expo Storage
A secure storage adapter plugin for the Dressipi SDK that provides mobile-optimized credential management using Expo SecureStore.
## Overview
This plugin extends the Dressipi SDK with secure storage capabilities specifically designed for React Native applications using Expo. It provides a `SecureStoreAdapter` class that implements secure credential storage, retrieval, and management using Expo's SecureStore API.
The `SecureStoreAdapter` ensures that sensitive authentication data is stored securely on the device, leveraging the native keychain on iOS and the Android Keystore system on Android.
## Installation
### Prerequisites
First, make sure you have the main Dressipi SDK installed:
```bash
npm install mapp-fashion-react-native-sdk
```
### Install the Plugin
```bash
npm install mapp-fashion-react-native-sdk-expo
```
### Install Expo SecureStore
This plugin requires Expo SecureStore as a peer dependency:
```bash
npx expo install expo-secure-store
```
## Usage
### Basic Setup
Import the `SecureStoreAdapter` and pass it to your `DressipiProvider`:
```typescript
import React from 'react';
import { DressipiProvider } from 'mapp-fashion-react-native-sdk';
import { SecureStoreAdapter } from 'mapp-fashion-react-native-sdk-expo';
const App = () => {
return (
{/* Your app content */}
);
};
export default App;
```
## Configuration
The `SecureStoreAdapter` works out of the box with no additional configuration required. The SDK will automatically handle:
- Credential storage and retrieval
- Token refresh management
- Secure cleanup on logout
- Error handling and fallbacks
## Requirements
- React Native with Expo
- iOS 10.0+ or Android API level 21+
- Expo SecureStore (automatically handles platform requirements)
## Troubleshooting
### Common Issues
**SecureStore not available**: Ensure you're running on a physical device or a simulator with keychain support. The iOS Simulator and Android Emulator support SecureStore.
**Authentication errors**: Make sure your `clientId` and `domain` are correctly configured in the `DressipiProvider`.
**Storage errors**: Check that your app has the necessary permissions and that SecureStore is properly installed.
## Support
For issues related to this storage adapter, please check the main Dressipi SDK documentation or contact support.
## License
This plugin follows the same license as the main Dressipi SDK.