Embed the widget in mobile apps

dependencies: [
    .package(url: "https://github.com/QuackbackIO/quackback-ios", from: "1.0.0"),
],
targets: [
    .target(name: "YourApp", dependencies: ["Quackback"]),
]

import Quackback
 
// 1. Configure once at app startup
Quackback.configure(QuackbackConfig(
    appId: "your-app-id",
    baseURL: URL(string: "https://feedback.yourapp.com")!,
    locale: "fr"  // optional — omit to auto-detect
))
 
// 2. Identify the current user
Quackback.identify(userId: "user_123", email: "user@example.com", name: "Jane Smith")
// or, with a server-signed token (recommended for production):
Quackback.identify(ssoToken: fetchedSsoToken)
// or, for unauthenticated visitors:
Quackback.identify()
 
// 3. Show the floating launcher button
Quackback.showLauncher()

Quackback.configure(
    QuackbackConfig(appId: "your-app-id", baseURL: URL(string: "https://feedback.yourapp.com")!),
    identity: .user(id: "user_123", email: "user@example.com", name: "Jane Smith")
)
// Also accepts .ssoToken("..."). Omit the `identity` parameter for anonymous sessions.

QuackbackConfig(
    appId: String,                              // required
    baseURL: URL,                               // required
    theme: QuackbackTheme = .system,            // .light | .dark | .system
    position: QuackbackPosition = .bottomRight, // .bottomRight | .bottomLeft
    buttonColor: String? = nil,                 // hex e.g. "#6366F1"
    locale: String? = nil                       // "en", "fr", "de", "es", "ar"
)

Quackback.open()                         // default view
Quackback.open(board: "feature-requests") // specific board

let token = Quackback.on(.vote) { data in
    print("Voted on post:", data["postId"] ?? "")
}
 
// Stop listening
Quackback.off(token)

Quackback.logout()   // clear identity
Quackback.destroy()  // tear down SDK entirely

dependencies {
    implementation("com.quackback:sdk:0.1.0")
}

// In your Application class
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        Quackback.configure(
            context = this,
            config = QuackbackConfig(
                appId = "your-app-id",
                baseURL = "https://feedback.yourapp.com"
            )
        )
    }
}
 
// After user signs in
Quackback.identify(
    userId = "user_123",
    email = "user@example.com",
    name = "Jane Smith"
)
// or, with a server-signed token (recommended for production):
Quackback.identify(ssoToken = fetchedSsoToken)
// or, for unauthenticated visitors:
Quackback.identify()
 
// If you already know the user at app startup, bundle identity into configure:
Quackback.configure(
    context = this,
    config = QuackbackConfig(appId = "your-app-id", baseURL = "https://feedback.yourapp.com"),
    identity = Identity.User(id = "user_123", email = "user@example.com", name = "Jane Smith")
)
// Also accepts Identity.SsoToken("..."). Omit the `identity` parameter for anonymous sessions.
 
// Show the launcher button in your Activity
Quackback.showLauncher()

Quackback.open()
Quackback.open(board = "feature-requests")

val token = Quackback.on(QuackbackEvent.VOTE) { data ->
    Log.d("Quackback", "Voted on: ${data["postId"]}")
}
 
Quackback.off(token)

Quackback.logout()   // clear identity
Quackback.destroy()  // tear down SDK