Skip to main content

Quickstart

This page provides the shortest path to integrate Fidbek on React Native, Expo, iOS, Android, and Flutter.

1. Prepare your SDK token

Create or select your project/workspace and obtain the SDK token used by mobile apps.

2. Add the SDK dependency

React Native / Expo (npm)

npm install @saltware/fidbek-react-native

iOS (SPM)

  • Package URL: https://github.com/Saltware-Tech/fidbek-ios.git
  • Product: FidbekSDK
  • Version: latest stable 0.3.x release tag

Android (Maven)

maven("https://raw.githubusercontent.com/Saltware-Tech/fidbek-android/main/maven")
implementation("com.fidbek:fidbek-android:0.3.0")

Flutter (pub.dev)

dependencies:
fidbek_flutter: ^0.3.0

3. Initialize on app startup

React Native / Expo

import Fidbek from '@saltware/fidbek-react-native';

await Fidbek.configure({
token: 'YOUR_TOKEN',
shakeToOpenEnabled: true,
});

iOS

Fidbek.shared.configure(
token: "YOUR_TOKEN"
)

Android

Fidbek.initialize(
application = this,
token = "YOUR_TOKEN"
)

Flutter

await FidbekFlutter.configure(
token: "YOUR_TOKEN",
);

4. Optionally identify the current user

At least one of userId, name, or email is required.

React Native / Expo

await Fidbek.identify({
userId: 'user_123',
email: 'talha@example.com',
});

iOS

Fidbek.shared.identify(
userId: "user_123",
email: "talha@example.com"
)

Android

Fidbek.identify(
userId = "user_123",
email = "talha@example.com"
)

Flutter

await FidbekFlutter.identify(
userId: 'user_123',
email: 'talha@example.com',
);

Call clearIdentity() on logout or account switch.

5. Add manual trigger action

React Native / Expo

await Fidbek.open();

iOS

Fidbek.shared.present()

Android

Fidbek.open()

Flutter

await FidbekFlutter.open();

What users get in 0.3.0

  • Compact report UI parity across iOS and Android.
  • Bug occurrence frequency selector in report form.
  • Built-in localized strings for en, tr, es, fr, de, pt, ar, hi, ja, and zh-Hans / zh-CN.
  • Automatic fallback to English for unsupported device locales.
  • Persistent installation identity for identified or anonymous usage tracking.
  • Contact email prefill from identified user email when present.
  • Lower Android shake sensitivity to reduce accidental opens.

Endpoint behavior

The report endpoint is fixed internally in current SDKs:

https://api.fidbek.dev/v1/sdk/reports

Next: How It Works