📞 Callen – Phone Dialer App (Kotlin + MVVM + AdMob)

Callen is a production-ready Phone Dialer Android application built using Kotlin, XML, MVVM Architecture, and AdMob integration.

This project demonstrates how real Android system-style apps are structured including T9 search, call history management, runtime permissions, and modern UI design.

---

Perfect for: • Resume projects
• Final year college submissions
• Hackathons
• Android portfolio

---

🚀 Features

✔ Clean & modern dialer interface
✔ T9 dial pad with fast search functionality
✔ Complete call history screen
✔ Contacts list with quick actions
✔ Direct calling functionality
✔ Runtime permission handling
✔ Light & Dark theme support
✔ AdMob Banner Ads
✔ AdMob Interstitial Ads
✔ MVVM architecture with clean folder structure
✔ Production-style project organization
✔ App publishing preparation (Indus Appstore ready)

---

📂 Core Modules

• Dial Pad Module
• Contacts Module
• Call History Module
• Permission Manager
• AdMob Integration Module
• Theme Manager

---

🏗 Architecture

• MVVM Architecture
• Repository Pattern
• ViewModel + LiveData
• Clean code structure
• Modular folder setup
• Scalable Android design

---

🛠 Tech Stack

• Kotlin
• XML
• Android Studio
• MVVM
• Firebase (Optional backend support if used)
• Google AdMob

---

📂 Project Structure

CallenDialerApp/ │ ├── data/ ├── ui/ ├── viewmodel/ ├── repository/ ├── permissions/ ├── ads/ └── utils/

---

🔐 Permissions Handling

• CALL_PHONE permission
• READ_CONTACTS permission
• READ_CALL_LOG permission
• Runtime permission management
• Safe permission request flow

---

💰 Monetization

• Google AdMob Banner Ads
• Google AdMob Interstitial Ads
• Production-ready ad placement

---

📱 App Publishing

• Release build generation
• SHA1 / SHA256 setup
• Signed APK / AAB preparation
• Indus Appstore publishing readiness

---

🧪 How to Run

1. Clone this repository
2. Open in Android Studio
3. Configure AdMob App ID
4. Add required permissions in Manifest
5. Sync Gradle
6. Run on emulator or physical device

---

📌 Learning Outcomes

By building this project, you will learn:

• Android app development using Kotlin
• MVVM architecture implementation
• T9 search algorithm logic
• Runtime permission handling
• Call log & contacts management
• AdMob monetization integration
• Production-level Android app structure

---

🤝 Contributing

Contributions are welcome to improve features and performance.

---

⭐ Support

If you found this project helpful, please give it a star ⭐

---