📱 CellCard Unofficial App

Flutter Mobile Application — Cross-platform Telecom Experience

Built with 💙 by SereyodamChek

⚠️ Disclaimer: This is an unofficial, community-built application and is not affiliated with, endorsed by, or officially connected to CellCard. For official services, please visit cellcard.com.

---

📌 About This Project

CellCard Unofficial App is a Flutter-based mobile application designed to provide CellCard users with a clean, intuitive interface for managing mobile services, checking balances, purchasing packages, and exploring available offers.

Built with modern Flutter practices, this project demonstrates cross-platform development, responsive UI design, and seamless user experience — all while serving as a learning resource for telecom app development.

---

🚀 Key Features

Category	Features
📊 Usage Tracker	View data, call & SMS usage in real-time
🛒 Package Store	Browse & purchase data/call packages easily
👤 Account Hub	Profile info, transaction history & settings
⚙️ Quick Settings	Toggle notifications, language & theme
📱 Cross-Platform	Android, iOS, Web, Windows, macOS, Linux
🎨 Modern UI	Material Design 3 with smooth animations

---

🛠️ Tech Stack

Layer	Technology
Framework	Flutter (Dart)
UI Design	Material Design 3
Navigation	GoRouter / AutoRoute
State Management	Riverpod / Provider / BLoC
Local Storage	Shared Preferences / Hive / SQLite
Networking	Dio / HTTP

---

📂 Project Architecture

📦 CellCard_Unofficial_App
├── 📁 lib/
│   ├── 🚀 main.dart              → App entry point
│   ├── 📁 core/                  → Constants, themes, routing, utilities
│   ├── 📁 features/              → Feature modules (home, account, store, settings, about)
│   └── 📁 shared/                → Reusable widgets & components
├── 📁 android/                   → Android-specific configs
├── 📁 ios/                       → iOS-specific configs
├── 📁 web/                       → Web-specific configs
├── 📁 windows/                   → Windows Desktop configs
├── 📁 macos/                     → macOS Desktop configs
├── 📁 linux/                     → Linux Desktop configs
├── 📁 test/                      → Unit & widget tests
├── 📄 pubspec.yaml               → Dependencies & metadata
└── 📄 README.md                  → Documentation

---

⚙️ Getting Started

1. Install Flutter

👉 Flutter Installation Guide

2. Clone Repository

git clone https://github.com/SereyodamChek/CellCard_Unofficial_App.git
cd CellCard_Unofficial_App

3. Install Dependencies

flutter pub get

4. Run the App

flutter run

---

▶️ Platform-Specific Commands

flutter run -d chrome      # 🌐 Web
flutter run -d android     # 📱 Android
flutter run -d ios         # 🍎 iOS (macOS required)
flutter run -d windows     # 🪟 Windows Desktop
flutter run -d macos       # 🖥️ macOS Desktop
flutter run -d linux       # 🐧 Linux Desktop

---

🎯 Project Purpose

Goal	Description
✨ Flutter Practice	Real-world UI patterns & animations
📱 Telecom Features	Balance checks, packages, usage tracking
🚀 Production Mockup	Portfolio-ready application
🔄 Cross-Platform	Single codebase for all platforms
🔌 Backend Ready	Prepared for API integration & auth

---

📈 Roadmap

• 🔐 Mock authentication & OTP verification
• 🌐 Live CellCard API integration
• 🔔 Push notifications for package expiry
• 🌍 Khmer / English bilingual support
• 💳 In-app payment simulation (ABA PayWay / KHQR)
• 📊 Advanced analytics with charts
• 🎨 Custom theme builder & accessibility

---

⚠️ Important Notes

Frontend/UI-focused educational project — All data is mock/static. No real CellCard account connections. Optimized for learning, portfolio display, and interview preparation. Free to fork, study, and adapt!

---

📫 Connect With Me

Platform	Link
GitHub	@SereyodamChek
Email	sereyodamc011@gmail.com
Portfolio	cheksereyodam.site

🐛 Report Issue • 💡 Request Feature

---

_{⭐ Building useful mobile experiences through clean Flutter code — one widget at a time. 💙}

```