menu
close

#Install Access on React Native

The easiest way to add Poool Access to your React Native app ✨

#Requirements

  • React Native >= 0.78 (not tested on older versions)
  • React Native Permissions >= 5.3.0 (not tested on older versions) (see react-native-permissions' setup for more details)

#Installation

⚠️ Important: This package is a wrapper that requires native Poool SDKs to be linked to your project. React Native does it automatically for you, but if you encounter any issues, please refer to the React Native documentation about linking native libraries.

#Additional step for iOS

After installing dependencies, add the necessary ReactNativePermission config to your Podfile and request the AppTrackingTransparency permission:
And reinstall pods:

#Usage

#Documentation

#AccessContext

<AccessContext />

#Props

  • appId {String} Your Poool App ID
  • config {Object} (optional) Default paywall config (see the configuration documentation).
  • styles {Object} (optional) Default paywall styles (see the styles documentation).
  • texts {Object} (optional) Default paywall texts (see the texts documentation).
  • variables {Object} (optional) Paywall variables (see the variables documentation).

#RestrictedContent

<RestrictedContent />

#Props

  • id {String} (optional, default: null) Paywall id

#Snippet

<Snippet />

#Props

  • id {String} (optional, default: null) Paywall id

#Paywall

<Paywall />

#Props

  • id {String} (optional, default: null) Paywall id: used to link the paywall release event to the corresponding snippet/restricted content
  • displayMode {String} (optional, default: 'default') Display mode of the paywall (supported modes: default, bottom-sheet)
  • pageType {String} (optional, default: 'premium') Current page type (supported types: page, premium, free)
  • config {Object} (optional) Paywall config (see the configuration documentation).
  • styles {Object} (optional) Paywall styles (see the styles documentation).
  • texts {Object} (optional) Paywall texts (see the texts documentation).
  • variables {Object} (optional) Paywall variables (see the variables documentation).
  • on* {Function} (optional) Event listeners (see the events documentation).

#Example

#useAccess()

Can be used to retrieve some properties from the current access context.

#Returns

  • appId {String} Current app ID
  • config {Object} Current access context config
  • texts {Object} Current access context texts
  • styles {Object} Current access context styles
  • variables {Object} Current access context variables

#Example

#Contributing

Please check the CONTRIBUTING.md doc for contribution guidelines.

#Development

Install dependencies:
(Optional - iOS Only) Install pods:
Run examples:
or

#Known issues

yarn example android fails with command "node" failed

  • Stop all gradlew daemons: cd example/android && ./gradlew --stop
  • Ensure the right node version is selected nvm use
  • Run yarn example android again

#Cannot gradle sync for an unknown reason

  • Stop all gradlew daemons: cd example/android && ./gradlew --stop
  • Retry

#License

This software is licensed under MIT.