Flutter SDK quickstart

era_flutter creates and stores a visitorId. Your backend sends that ID and the conversation to Era with the Node SDK.

Never put a secret Node SDK API key in your Flutter app.

Install

Add the package to pubspec.yaml:

dependencies:
  era_flutter: ^0.1.0
  http: ^1.5.0

Create the client

import 'package:era_flutter/era_flutter.dart';

final era = EraFlutter(
  baseUrl: 'https://your-era-endpoint.com',
  publishableKey: 'your_publishable_key',
);

A publishable key can be included in the app.

Initialize the visitor

final visitorId = await era.init();

The SDK reuses the visitor across app launches when preferences are available.

Send the visitor to your backend

import 'dart:convert';

import 'package:http/http.dart' as http;

await http.post(
  Uri.parse('https://your-app.example.com/api/chat'),
  headers: {'Content-Type': 'application/json'},
  body: jsonEncode({
    'messages': messages,
    'visitorId': visitorId,
    'sessionId': sessionId,
  }),
);

For the server-side integration flow, see the Node SDK quickstart.

Verify email or phone

Your app owns the verification UI:

final challenge = await era.startVerification(
  VerificationType.email,
  'person@example.com',
);

final result = await era.confirmVerification(
  challenge.challengeId,
  enteredCode,
);

Use VerificationType.phone with an E.164 phone number. Use resendVerification() only after a user action. The SDK does not store codes or challenge details. Keep them only in temporary UI state. eraEndUserId is a continuity hint, not proof that the user is authenticated in your app.

Reset and close

Reset the visitor after logout, account switching, or a shared-device user change:

final replacementVisitorId = await era.resetVisitor();

Call close() when you are finished with the client:

era.close();

API and network failures throw EraFlutterException. Inspect code, message, retryable, and statusCode.

Get started

Concepts

Reference

Flutter SDK quickstart

Verify email or phone

Reset and close

Next steps

Identity lifecycle

Flutter SDK reference

​Verify email or phone

​Reset and close

​Next steps

Identity lifecycle

Flutter SDK reference

Verify email or phone

Reset and close

Next steps