This repository hosts the essential components of the Hyperswitch SDK, which supports various platforms. Directly cloning this repository allows immediate access to a web-compatible version of the SDK.

Important: The official Hyperswitch Web SDK is maintained separately. Visit this link for details.

The hyperswitch-client-core is designed to function within a git submodule framework, facilitating integration with iOS, Android, React Native, Flutter, and Web platforms.

For Android or iOS integration, initialize the necessary submodules using:

git submodule update --init --recursive

To install required dependencies:

yarn install

Rename .en file to .env and input your Hyperswitch API and Publishable Key. Get your Hyperswitch keys from Hyperswitch dashboard

Launch two terminal instances to start the servers:

yarn run server     # This starts the mock server
yarn run re:start   # This initiates the Rescript compiler

To begin the metro server for native app development:

yarn run start

To run the playground, use the following commands based on the target platform:

Upon successful setup, your application should be operational on your Android Emulator or iOS Simulator, assuming the emulator or simulator is configured properly. Additionally, the application can be executed directly from Android Studio or Xcode.

The following table outlines the available configuration variables, their values, and descriptions:

HyperswitchSource defaults to LocalHosted.

Note: To run the SDK on a physical iOS device, ensure that your Mac and the iOS device are connected to the same Wi-Fi network. Additionally, you'll need to provide your Mac's IP address as the value for the HyperswitchSourceIP key, as shown in the following table:

Replace 10.0.0.1 with your actual Mac's IP address.

During local development, you may need to set specific variables to configure the SDK's behavior. You can set these variables using Xcode, command line interface (CLI), or any text editor. All changes will be made inside ios folder(submodule).

Project > Targets > Info Custom iOS Target Properties

Alternatively, you can leverage the plutil command to modify the Info.plist file directly from the terminal. For example, to set the HyperswitchSource variable, execute the following command:

plutil -replace HyperswitchSource -string "LocalBundle" Info.plist

Info.plist is present in hyperswitch directory.

If you prefer a more manual approach, you can open the Info.plist file in a text editor and add or modify the required keys and their corresponding values. For instance:

<key>HyperswitchSource</key>
<string>LocalHosted</string>
<key>HyperswitchSourceIP</key>
<string>10.0.0.1</string>

Get started with our 📚 integration guides

• Hyperswitch Client Core License