Flutter

Customer support for your Flutter app

Riverpod state management, GoRouter-compatible screens, and a configurable auth hooks system. A complete customer support UI library that integrates into any Flutter application.

Read the Docs View on GitHub

pubspec.yaml

escalated:
  git:
    url: https://github.com/escalated-dev/escalated-flutter.git

Why Escalated

Why Escalated for Flutter

A native Flutter library designed for your customer-facing support experience.

Riverpod State Management

Tickets, articles, and auth state are managed through Riverpod providers. Reactive, testable, and composable — following Flutter best practices.

Platform-Native Widgets

StatusBadge, PriorityBadge, SlaTimer, SatisfactionRating, and more — all built with Material Design and dark/light theme support.

Auth Hooks System

Override login, logout, register, and token refresh behavior. Use the default Bearer token implementation or plug in your own auth flow.

Getting Started

How It Works

Three steps from zero to a working help desk.

Add the Dependency

Add escalated to your pubspec.yaml

Install Packages

flutter pub get

Wrap Your App

Wrap your app with EscalatedPlugin, pass your API base URL, and wire the screens into your GoRouter.

Features

Built for Flutter

Everything you need for a customer support experience in your Flutter app.

Riverpod Providers

Auth, tickets, knowledge base, and theme state are managed through Riverpod. Watch providers reactively and compose state across screens.

GoRouter Navigation

All screens are GoRouter-compatible widgets. Wire them into your existing navigation or use the included route definitions.

Dark & Light Theme

Full dark and light mode support using Material Design tokens. Respects system preferences and allows manual toggle.

4-Language i18n

English, Spanish, French, and German translations included. All customer-facing strings are localizable.

Configurable Design Tokens

Override the primary color, border radius, and other design tokens through EscalatedConfig to match your app's brand.

Complete Screen Set

Login, register, ticket list, create ticket, ticket detail with replies, knowledge base, guest access, and settings — all production-ready.

Code

Simple Integration

A few lines to add customer support to your Flutter app.

// main.dart
import 'package:escalated/escalated.dart';

void main() {
  runApp(
    ProviderScope(
      child: EscalatedPlugin(
        config: EscalatedConfig(
          baseUrl: 'https://api.example.com',
          primaryColor: Colors.indigo,
        ),
        child: MaterialApp.router(
          routerConfig: GoRouter(
            routes: [
              ...escalatedRoutes,
              ...yourAppRoutes,
            ],
          ),
        ),
      ),
    ),
  );
}

Ready to add support tickets to your Flutter app?

Install the library, wrap your app, and wire the screens. Open source and free forever.

Read the Documentation View on GitHub