Compose Call Guard 🛡️

Compose Call Guard is a lightweight, privacy-focused Android call blocking application built with modern Android architecture.

Unlike traditional blockers that rely on cloud databases, this app uses Regular Expressions (Regex) to give users granular, offline control over who can reach them. It features a stunning Material You interface that adapts to your device's wallpaper.

👉 Download Latest APK

---

✨ Key Features

• Regex Power: Filter calls using powerful Regular Expressions (e.g., ^1\d{2}.* blocks specific prefixes).
• Dual-Layer Filtering:
  1. Whitelist (Priority): Numbers matching these rules are always allowed.
  2. Blacklist: Numbers matching these rules are silently rejected.
• Privacy-by-Design: Runs 100% offline using Android's native CallScreeningService. Zero network permissions, no contacts uploaded, zero data leaves the device.
• Material You Design: Built entirely with Jetpack Compose and Material 3, supporting Dynamic Colors.
• History Log: Keep track of blocked calls with timestamps and matched rules.

📸 Screenshots

Block History	Settings & Rules	Add Regex Rule

🛠️ Tech Stack

• Language: Kotlin
• UI Toolkit: Jetpack Compose (Material Design 3)
• Architecture: MVVM (Model-View-ViewModel)
• Database: Room (SQLite abstraction)
• Storage: Jetpack DataStore (Preferences)
• System API: CallScreeningService (Android 10+)
• Concurrency: Kotlin Coroutines & Flow

🚀 Getting Started

Prerequisites

• Android Studio Iguana or newer.
• JDK 21+.
• Android Device/Emulator running API Level 29 (Android 10) or higher.

Installation

1. Clone the repository:

   git clone https://github.com/AndrewWangDev/Compose-Call-Guard.git

2. Open the project in Android Studio.
3. Sync Gradle and Build.
4. Important: After installation, go to Settings -> Apps -> Default Apps -> Caller ID & Spam App and select Compose Call Guard.

💡 How It Works

The app utilizes the CallScreeningService API. When an incoming call arrives:

1. The system wakes up the service.
2. The app checks the Master Switch in DataStore (Synchronously).
3. It validates the number against Whitelist Regexes from Room Database.
4. If not whitelisted, it checks against Blacklist Regexes.
5. If matched, the call is rejected without notification, and the event is logged asynchronously.

🤝 Project Status & Contributions

This repository is currently in a completed and archived (read-only) state. New feature pull requests are no longer being merged into main.

You are warmly encouraged to fork this repository under the MIT License and build upon it for custom filtering needs.

📄 License

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

---

Developed by Andrew Wang