Flutter quickstart - ClarioDesk

The ClarioDesk Flutter SDK (clariodesk on pub.dev) gives you a hardware-bound device identity and a live ticket thread with a few method calls.

Install

flutter pub add clariodesk

Requires Flutter ≥ 3.41 / Dart ≥ 3.11, iOS 13+, Android API 23+.

Initialize

The first init generates the hardware key and registers the device with the backend. Subsequent launches reuse the existing key with no network call.

import 'package:clariodesk/clariodesk.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ClarioDesk.init(apiKey: 'pk_live_…');
  runApp(const MyApp());
}

Identify the user

Call this after your own auth knows who the user is. It’s optional, pure metadata. See lifecycle for the four events you should wire (especially case 1, which covers users who were logged in before you installed the SDK). externalId is your auth system’s stable user id (Firebase user.uid, Clerk user.id, Auth0 user.sub) — never an auth token, never an email; full table.

await ClarioDesk.identify(
  externalId: hostUser.id,
  email: hostUser.email,
  traits: {'plan': 'pro'},
);

File a ticket

final t = await ClarioDesk.createTicket(
  subject: 'Upload broken',
  body: 'Tapping upload does nothing.',
);

Stream the inbox & a thread

Reactive reads: both auto-prime, then live-update.

// Inbox
StreamBuilder<List<Ticket>>(
  stream: ClarioDesk.ticketsStream(),
  builder: (_, snap) {
    final tickets = snap.data ?? const [];
    return ListView(/* render tickets */);
  },
);

// A single thread
StreamBuilder<List<Message>>(
  stream: ClarioDesk.messagesStream(t.id),
  builder: (_, snap) => /* render messages */,
);

Send a reply

await ClarioDesk.sendMessage(t.id, 'Still happening on 1.4.2');

Run the example app

cd example
flutter run --dart-define=CLARIODESK_API_KEY=pk_live_…

Lifecycle integration

Wire login, launch, logout, and user-switch.

Prebuilt UI

Skip building the UI. Open a themeable inbox in one call.

​Install

​Initialize

​Identify the user

​File a ticket

​Stream the inbox & a thread

​Send a reply

​Run the example app