Adovvy SDK (Flutter)

What you get

• Simple API: initialize once, open chat from anywhere.
• Full-screen chat UI: opens the chatbot in a full-screen route.
• Close button support: the chatbot “X” requests closing the Flutter route.

Installation

Install from pub.dev.

flutter pub add adovvy_sdk

Or add it manually in your app pubspec.yaml (package name is adovvy_sdk, all lowercase):

dependencies:
  adovvy_sdk: ^1.0.0

Use the latest version shown on pub.dev (the caret range above is just an example).

Quick start

Initialize once (e.g. in main.dart) and then open chat from any screen.

Do not hardcode chatbotId, servers, or script URLs in source control. Load them from your app’s secure configuration (remote config, encrypted storage, CI secrets, etc.). The snippet below uses compile-time --dart-define values so IDs/URLs are not embedded in the README or your repo as literals.

import 'package:adovvy_sdk/adovvy_sdk.dart';
import 'package:flutter/material.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await AdovvySdk.init(
    chatbotConfig: AdovvyChatbotConfig(
      chainlitServer: "https://......",
      chatbotId: "ac35.....",
      buttonColor: '#000000',
      loaderScriptUrl: "https://......",
      scripts: const [
        "https://.....",
      ],
    ),
  );

  runApp(const MyApp());
}

Open chat:

AdovvySdk.openChat(context);

Example button:

import 'package:adovvy_sdk/adovvy_sdk.dart';
import 'package:flutter/material.dart';

class SupportButton extends StatelessWidget {
  const SupportButton({super.key});

  @override
  Widget build(BuildContext context) {
    return FilledButton(
      onPressed: () => AdovvySdk.openChat(context),
      child: const Text('Chat with us'),
    );
  }
}

Configuration

Everything is configured via a single AdovvyChatbotConfig passed to AdovvySdk.init(...).

• chainlitServer (String, required): server base URL used by the chatbot runtime.
• chatbotId (String, required): chatbot identifier (mapped to JS as chatbotID).
• buttonColor (String, required): CSS hex #RRGGBB.
• loaderScriptUrl (String, required): URL to the loader script (<script src="...">).
• scripts (List<String>, required): runtime script URLs passed to the loader config.

API

• AdovvySdk.init({ required AdovvyChatbotConfig chatbotConfig })
  • Call once before any chat is opened.
• AdovvySdk.openChat(BuildContext context)
  • Opens the full-screen chat route.
  • If init was not called, logs to the console (via debugPrint + FlutterError.reportError).
  • If loaderScriptUrl / scripts are missing/empty in AdovvyChatbotConfig, logs to the console.

Example app

See adovvy_sdk/example/ for a minimal Flutter app that initializes the SDK and opens chat.

If you need support, please fill out this form: Support form.