Skip to content

Home

Jump to bottom
Venkata Najeer Kopparapu edited this page May 21, 2026 · 1 revision

Msgs — Wiki

Welcome to the official wiki for Messages, a modern on-device SMS client for Android built with Flutter.

Table of Contents

Overview

Msgs is a fast, intelligent SMS client for Android. It parses and categorizes your SMS inbox entirely on-device — no data leaves your phone. It offers instant OTP copying, visual transaction summaries, and a clean Material You interface.

⚠️ The app is currently under active development. Basic SMS reading and chatting works. MMS and link detection are not yet supported.

Features

🧠 Intelligent Message Classification

Msgs automatically sorts your inbox into:

Category Description
🔑 OTPs One-time passwords from services
💳 Banking Credits, debits, and transactions
💬 Personal Messages from saved contacts
📢 Promotions Offers and discount alerts
🛡️ Spam / Unknown Auto-filtered unrecognized senders

Known Issues

  • Isar build issue: If you face build errors related to isar_flutter_libs, switch to the community version available on pub.dev.
  • MMS not supported — sending multimedia messages is not yet implemented.
  • Link detection — coming in a future update.

Roadmap

  • SMS inbox reading and classification
  • OTP detection and one-tap copy
  • Transaction card UI
  • Material You dynamic theming
  • Chat bubbles
  • Link detection in messages
  • MMS support
  • Full SMS sending support

License

This project is licensed under the MIT License. See the LICENSE file for details.

# Msgs — Wiki

Welcome to the official wiki for Msgs, a modern on-device SMS client for Android built with Flutter.

Table of Contents

Overview

Msgs is a fast, intelligent SMS client for Android. It parses and categorizes your SMS inbox entirely on-device — no data leaves your phone. It offers instant OTP copying, visual transaction summaries, and a clean Material You interface.

⚠️ The app is currently under active development. Basic SMS reading and chatting works. MMS and link detection are not yet supported.

Features

🧠 Intelligent Message Classification

Msgs automatically sorts your inbox into:

Category Description
🔑 OTPs One-time passwords from services
💳 Banking Credits, debits, and transactions
💬 Personal Messages from saved contacts
📢 Promotions Offers and discount alerts
🛡️ Spam / Unknown Auto-filtered unrecognized senders

⚡ One-Tap OTP Actions

Detects OTP codes along with the service name and expiry. Tap to copy instantly.

📊 Visual Transaction Tracker

Extracts INR (₹) amounts, debit/credit type, and account endings. Renders summary cards in your inbox.

🎨 Material You (Material 3)

Fully supports dynamic color theming (light/dark) using your system wallpaper color.

💾 Local-First Storage

Uses Isar Database for fast offline search, caching, and indexing. Everything stays on your device.

📱 OEM Permission Handling

Handles permission flows for stock Android and custom launchers — MIUI, HyperOS, and Funtouch OS included.

Architecture

The project follows a clean feature-driven architecture:

Msgs App
├── Shared Services
│   ├── SmsRepository
│   ├── MessageClassifier
│   ├── OtpParser
│   └── Isar Local DB
└── Feature Modules
    ├── Inbox (BLoC / Screen)
    ├── Permissions Screen
    ├── Banking: Transaction Cards
    ├── OTP: Copyable Cards
    └── Settings & Theme

Folder Structure

Folder Purpose
lib/core/ App themes, configs, and utilities
lib/services/ Repository layers, DB models, classifiers
lib/features/ UI modules — Inbox, Conversation, Banking, OTP, Permissions

Tech Stack

Layer Library
UI Framework Flutter SDK (Material 3)
State Management Flutter BLoC + Provider
Local Database Isar
Animations Flutter Animate
Theming Dynamic Color
Dependency Injection Get It

Getting Started

Prerequisites

  • Flutter SDK >= 3.11.4
  • Android SDK (emulator or physical device)

Installation

# 1. Clone the repo
git clone https://github.com/Najeer-k11/Messages-FlutterApp.git
cd Messages-FlutterApp

# 2. Install dependencies
flutter pub get

# 3. Generate Isar DB schemas
flutter pub run build_runner build --delete-conflicting-outputs

# 4. Run the app (Android device/emulator required)
flutter run

Permissions & Privacy

All processing happens strictly on-device. No messages or financial details are sent to any server.

Permission Reason
SMS Read local SMS storage and receive incoming messages
Contacts Resolve contact names from phone numbers
Default SMS Handler Optional — needed to handle incoming SMS events

Known Issues

  • Isar build issue: If you face build errors related to isar_flutter_libs, switch to the community version available on pub.dev.
  • MMS not supported — sending multimedia messages is not yet implemented.
  • Link detection — coming in a future update.

Roadmap

  • SMS inbox reading and classification
  • OTP detection and one-tap copy
  • Transaction card UI
  • Material You dynamic theming
  • Chat bubbles
  • Link detection in messages
  • MMS support
  • Full SMS sending support

License

This project is licensed under the MIT License. See the [LICENSE](../LICENSE) file for details.

Clone this wiki locally