Orientação gerada a partir de informações públicas. Apenas para referência.
Uma interface de chat totalmente funcional para Flutter que permite aos usuários enviar mensagens de texto, notas de voz e imagens. Construída com um design limpo e responsivo, integra-se perfeitamente em aplicativos móveis voltados para Android e iOS. O pacote simplifica a implementação de chat fornecendo componentes pré-construídos e gerenciando fluxos comuns de mensagens. Suporta exibição em tempo real de mensagens e inclui capacidades básicas de anexos multimídia, tornando-o ideal para aplicações focadas em comunicação.
Casos de uso
Aplicativos de mensagens instantâneas
Interfaces de suporte ao cliente
Recursos de bate-papo em grupo
Plataformas de redes sociais
Ferramentas de colaboração interna da equipe
Principais recursos
Envio de mensagem de texto
Gravação e reprodução de nota de voz
Suporte a anexos de imagem
Compatibilidade multiplataforma (Android e iOS)
Componentes de interface do usuário pré-construídos e personalizáveis
Indicado para
Desenvolvedores construindo aplicativos com muitos chats
Equipes que precisam de integração rápida de bate-papo
Soluções de comunicação com foco em dispositivos móveis
Prototipagem rápida de recursos de bate-papo
Considerações
Requer backend adicional para persistência de mensagens
Limitado a tipos básicos de mídia (sem vídeo ou arquivos)
Sem autenticação de usuário embutida
Lógica personalizada necessária para sincronização em tempo real
Pode ser necessário ajustes de estilo para alinhamento da marca
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
chat_package
A ready-made, highly customizable chat UI for Flutter. Drop in ChatScreen,
wire up a handful of callbacks, and you get text messages, voice notes with
slide-to-cancel, gallery images, an in-app camera, and video messages — out of
the box.
Created by Omar Mouki
Features
💬 Text messages with a customizable input field
🎙️ Voice notes — hold to record, slide to cancel, built-in playback with a seek slider
🖼️ Images from the gallery, shown inline with a full-screen viewer
📷 In-app camera — capture photos and videos with a caption step
🎞️ Video messages — inline thumbnail with tap-to-play full screen
🎨 Highly customizable — colors, sizes, text direction (LTR/RTL), icons, hints and more
🧩 Callback-driven: you own your data and state
Screenshots
Installation
Add the package to your pubspec.yaml:
dependencies:chat_package:^2.1.0
Then run flutter pub get.
Requires Dart >= 3.0 and Flutter >= 3.16.
Platform setup
The package requests the runtime permissions it needs (microphone, camera,
photos) for you — you only need to declare them.
Android
In android/app/build.gradle, make sure the minimum SDK is at least 23
(required by the audio recorder):
android {
defaultConfig {
minSdkVersion 23
}
}
Add the permissions to android/app/src/main/AndroidManifest.xml:
Add the usage descriptions to ios/Runner/Info.plist:
<key>NSCameraUsageDescription</key><string>This app needs camera access to take photos and videos.</string><key>NSMicrophoneUsageDescription</key><string>This app needs microphone access to record voice notes.</string><key>NSPhotoLibraryUsageDescription</key><string>This app needs photo library access to attach images.</string>
And enable the matching permission_handler macros in ios/Podfile:
post_install do |installer|
installer.pods_project.targets.each do |target|
flutter_additional_ios_build_settings(target)
target.build_configurations.each do |config|
config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
'$(inherited)',
'PERMISSION_CAMERA=1',
'PERMISSION_MICROPHONE=1',
'PERMISSION_PHOTOS=1',
]
end
end
end
A message holds optional text and optional ChatMedia (an image/audio/video
url or local file path). It also offers toJson() / fromJson() so you can
persist and restore conversations from your backend.
ChatMessage(
isSender: true,
text: 'this is a banana',
chatMedia: ChatMedia(
url: 'https://example.com/banana.jpg',
mediaType: MediaType.image, // image | audio | video
),
);
Note:MediaType is now a plain enum (MediaType.image, MediaType.audio,
MediaType.video). See the migration guide below.
API reference
Required
Property
Type
Description
messages
List<ChatMessage>
The messages to render.
scrollController
ScrollController
Controls the chat list.
onTextSubmit
Function(ChatMessage)
Called when a text message is sent.
handleRecord
Function(ChatMessage?, bool canceled)
Called with the recorded voice note (or (null, true) when canceled).
handleImageSelect
Function(ChatMessage?)
Called with the selected/captured image (or null).
Common optional
Property
Type
Default
Description
handleVideoSelect
Function(ChatMessage?)?
null
Captured video callback; falls back to handleImageSelect if omitted.
MediaType is now an enum. Replace MediaType.imageMediaType() →
MediaType.image, MediaType.audioMediaType() → MediaType.audio,
MediaType.videoMediaType() → MediaType.video. (The Freezed dependency was
removed.)
New handleVideoSelect callback for the in-app camera's video captures.
In-app camera now returns captured photos/videos into the chat (with an
optional caption). The attachment camera option opens the in-app camera.
Android minSdkVersion must be >= 23 for the upgraded audio recorder.
New customization params: textDirection, containerBorderRadius,
buttonRadius, message width fractions, and capture-quality settings.
Found this project useful?
If this package helped you, please consider giving it a ⭐️ on
GitHub and sharing it.
Issues and feedback
Open an issue on GitHub with
suggestions, bugs or feature requests.