Quickstart

pod 'Grovs', '~> 3.1'

dependencies {
    implementation("io.grovs:Grovs:3.1.0")
}

dependencies:
  grovs_flutter_plugin: ^3.1.1

# Using npm
npm install react-native-grovs-wrapper
 
# Using yarn
yarn add react-native-grovs-wrapper

dependencies {
    implementation 'io.grovs:Grovs:3.1.0'
}

npm install grovs --save

import Grovs
 
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    Grovs.configure(APIKey: "your-api-key", useTestEnvironment: false, delegate: self) { success in
        if success {
            print("Grovs SDK is ready")
        }
    }
 
    return true
}

func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    return Grovs.handleAppDelegate(continue: userActivity, restorationHandler: restorationHandler)
}
 
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
    return Grovs.handleAppDelegate(open: url, options: options)
}

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Grovs.configure(this, "your-api-key", useTestEnvironment = false)
    }
}

class MainActivity : AppCompatActivity() {
    override fun onStart() {
        super.onStart()
        Grovs.onStart(this)
    }
 
    override fun onNewIntent(intent: Intent?) {
        super.onNewIntent(intent)
        Grovs.onNewIntent(intent, this)
    }
}

<application>
    <meta-data
        android:name="grovs_api_key"
        android:value="YOUR_API_KEY" />
    <meta-data
        android:name="grovs_use_test_environment"
        android:value="true" />
</application>

<key>GrovsApiKey</key>
<string>YOUR_API_KEY</string>
<key>GrovsUseTestEnvironment</key>
<true/>

import io.grovs.Grovs
import com.grovswrapper.GrovsConsent
 
override fun onCreate() {
    super.onCreate()
    Grovs.configure(
        this, "your-api-key", useTestEnvironment = false, baseURL = null,
        autoTrackScreenViews = false, clipboardDomains = null,
        enabled = GrovsConsent.isEnabled(this)
    )
}

import Grovs
import react_native_grovs_wrapper
 
override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    Grovs.configure(
        APIKey: "your-api-key", useTestEnvironment: false,
        autoTrackScreenViews: false, clipboardDomains: nil,
        enabled: GrovsWrapperSwift.isSDKEnabled(), delegate: nil
    )
    Grovs.setDebug(level: .info)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}

import Grovs from 'grovs';
 
await Grovs.configure({
    apiKey: 'your-api-key',
    testEnvironment: false,
    onDeeplink: (payload) => {
        // Called when the page was opened from a Grovs link
        console.log('Link payload:', payload);
    },
});

class YourViewController: UIViewController, GrovsDelegate {
 
    override func viewDidLoad() {
        super.viewDidLoad()
        Grovs.delegate = self
    }
 
    func grovsReceivedPayloadFromDeeplink(link: String?, payload: [String: Any]?, tracking: [String: Any]?) {
        // Route the user based on payload data
        if let screen = payload?["screen"] as? String {
            navigateTo(screen)
        }
    }
}

Grovs.setOnDeeplinkReceivedListener(this) { deeplinkDetails ->
    val link = deeplinkDetails.link
    val payload = deeplinkDetails.data
    val tracking = deeplinkDetails.tracking
 
    Log.d("Grovs", "Opened from: $link, payload: $payload")
}

import 'dart:async';
 
import 'package:flutter/material.dart';
import 'package:grovs_flutter_plugin/grovs.dart';
import 'package:grovs_flutter_plugin/models/grovs_link.dart';
 
class _AppState extends State<App> {
  final _grovs = Grovs();
  StreamSubscription<DeeplinkDetails>? _subscription;
 
  @override
  void initState() {
    super.initState();
    _subscription = _grovs.onDeeplinkReceived.listen((details) {
      final link = details.link;
      final payload = details.data;
 
      debugPrint('Opened from: $link, payload: $payload');
 
      // Route the user based on payload
      if (payload?['screen'] == 'product') {
        navigateToProduct(payload?['productId']);
      }
    });
  }
 
  @override
  void dispose() {
    _subscription?.cancel();
    super.dispose();
  }
}

import Grovs from 'react-native-grovs-wrapper';
 
const listener = Grovs.onDeeplinkReceived((response) => {
    console.log('Link:', response.link);
    console.log('Data:', response.data);
 
    // Route the user based on payload
    if (response.data?.screen === 'product') {
        navigation.navigate('Product', { id: response.data.productId });
    }
});
 
// When you no longer need the listener
listener.remove();

await Grovs.configure({
    apiKey: 'your-api-key',
    onDeeplink: (payload) => {
        if (payload.screen === 'product_detail') {
            showProduct(payload.productId);
        }
    },
});