Flutter SDK overview
Choose between the umbrella UI package, Flutter composition, pure Dart core, and Drift persistence.
Choose a package
| Package | Choose it when |
|---|---|
| v_chat_sdk | You want the complete Flutter umbrella: client, lifecycle, Drift persistence, and optional reusable chat widgets. |
| v_chat_flutter | You want the recommended Flutter client composition but will build your own UI. |
| v_chat_core | You want a pure-Dart client or need to provide your own offline/platform adapters. |
| v_chat_persistence_drift | You compose v_chat_core yourself and need the released scoped Drift storage ports. |
What the SDK owns
- Typed REST and realtime contracts, short-lived token refresh, cancellation, and stable errors.
- Scoped confirmed cache state, tombstones, reconnect checkpoints, and bounded recovery metadata.
- Flutter lifecycle and connectivity composition in v_chat_flutter.
- Optional immutable presentation models and reusable widgets in v_chat_sdk.
What your app still owns
- Login/logout, account switching, and the customer-backend token endpoint.
- Screen state, pagination, optimistic UI, retries, routing, dialogs, and attachment picking.
- Native push permission/provider configuration and notification presentation.
- Product-specific labels, accessibility validation, analytics, and moderation UX.