Providers

• Data Synchronization: Manages connections to peers and the Jazz cloud
• Local Storage: Persists data locally between app sessions
• Schema Types: Provides APIs for the AccountSchema
• Authentication: Connects your authentication system to Jazz

#Setting up the Provider

The provider accepts several configuration options:

#Provider Options

#Sync Options

The sync property configures how your application connects to the Jazz network:

import { type SyncConfig } from "jazz-tools";

export const syncConfig: SyncConfig = {
  // Connection to Jazz Cloud or your own sync server
  peer: `wss://cloud.jazz.tools/?key=${apiKey}`,

  // When to sync: "always" (default), "never", or "signedUp"
  when: "always",
};

See Authentication States for more details on how the when property affects synchronization based on authentication state.

#Account Schema

The AccountSchema property defines your application's account structure:

#Additional Options

The provider accepts these additional options:

• kvStore
  • ExpoSecureStoreAdapter (default)
• AccountSchema
  • Account (default)
• CryptoProvider
  • PureJSCrypto (default) - Pure JavaScript crypto provider
  • RNQuickCrypto - C++ accelerated crypto provider

#Authentication

Jazz for Expo includes built-in local persistence using SQLite. Following Expo's best practices, the Expo implementation uses:

• Database Storage: expo-sqlite - Expo's official SQLite module
• Key-Value Storage: expo-secure-store - Expo's secure storage system

Local persistence is enabled by default with no additional configuration required. Your data will automatically persist across app restarts.

#Quick Crypto

For accelerated crypto operations, you can use the RNQuickCrypto crypto provider.

To use it, install the following Packages:

pnpm add react-native-quick-crypto@1.0.0-beta.18 react-native-nitro-modules react-native-fast-encoder

Then add the following to your provider:

For configuration, use the RNQC Expo config plugin:

{
  "expo": {
    "plugins": [
      [
        "react-native-quick-crypto",
        {
          "sodiumEnabled": true
        }
      ]
    ]
  }
}

#Need Help?

If you have questions about configuring the Jazz Provider for your specific use case, join our Discord community for help.