MergeCore is a comprehensive Android application designed to revolutionize computer science education through AI-powered learning, curated content management, and an intuitive user experience.

• 🎯 Curated Learning Materials - Access expert-created content on CS fundamentals
• 🤖 AI Voice Assistant - Get instant answers with natural language processing
• 📚 Organized Content - Browse by categories, search, and bookmark favorites
• 🌓 Dark/Light Mode - Study comfortably in any environment
• 📱 Offline Access - Download materials for learning on the go
• 🎨 Modern UI - Beautiful, intuitive interface built with Material 3

• 📤 Content Management - Upload, edit, and delete educational materials
• 📊 Analytics Dashboard - Track user engagement and popular content
• 🔐 Secure Access - Role-based authentication with Firebase
• 📁 Multi-format Support - PDFs, videos, articles, and quizzes

• Language: Kotlin
• UI Framework: Jetpack Compose
• Architecture: MVVM (Model-View-ViewModel)
• Min SDK: API 24 (Android 7.0)
• Target SDK: API 34 (Android 14)

• Authentication: Firebase Auth
• Database: Cloud Firestore
• Storage: Firebase Storage
• Analytics: Firebase Analytics
• Crash Reporting: Firebase Crashlytics

• AI Provider: Google Gemini API
• Speech Recognition: Android SpeechRecognizer
• Text-to-Speech: Android TTS Engine

• Navigation: Jetpack Navigation Compose
• Image Loading: Coil
• Networking: Retrofit
• Coroutines: Kotlin Coroutines
• Dependency Injection: Hilt (optional)

app/
├── src/main/
│   ├── java/com/mastercs/fundamentals/
│   │   ├── data/
│   │   │   ├── models/          # Data classes
│   │   │   ├── repository/      # Data layer
│   │   │   └── remote/          # API services
│   │   ├── ui/
│   │   │   ├── auth/            # Login/Register screens
│   │   │   ├── admin/           # Admin dashboard & CMS
│   │   │   ├── student/         # Student learning interface
│   │   │   ├── assistant/       # AI voice assistant
│   │   │   ├── components/      # Reusable UI components
│   │   │   └── theme/           # App theming
│   │   ├── viewmodel/           # ViewModels
│   │   ├── utils/               # Utility classes
│   │   └── MainActivity.kt
│   └── res/                     # Resources
└── build.gradle.kts

• Android Studio Hedgehog (2023.1.1) or later
• JDK 17
• Firebase account
• Google Gemini API key

1. Clone or create the project

   # Follow instructions in QUICK_START.md

2. Configure Firebase

   • Create Firebase project
   • Add Android app
   • Download google-services.json to app/ directory
   • Enable Authentication, Firestore, and Storage

3. Add API Key

   • Create local.properties in project root
   • Add: GEMINI_API_KEY=your_api_key_here

4. Sync and Build

   ./gradlew build

5. Run the app

   • Connect device or start emulator
   • Click Run in Android Studio

For detailed setup instructions, see QUICK_START.md

A ready-to-open static website is now included under website/. It presents attractive simulated Android app screens for CodeCore in the browser.

open website/index.html
# or
python3 -m http.server 8000

Then open http://localhost:8000/website/ in your browser.

• User authentication system
• Role-based access (Admin/Student)
• Firebase integration

• Admin dashboard
• Upload/edit/delete materials
• Category management

• Browse and search materials
• Material viewer
• Bookmarks and favorites

• Gemini API integration
• Speech recognition
• Text-to-speech
• Chat interface

• Dark/Light theme
• Animations and transitions
• Responsive design

• Unit and integration tests
• Performance optimization
• Bug fixes

• Play Store preparation
• Security audit
• Release and monitoring

• ✅ Firebase Authentication with email/password
• ✅ Role-based access control
• ✅ Firestore security rules
• ✅ API key protection (BuildConfig)
• ✅ ProGuard code obfuscation
• ✅ Encrypted SharedPreferences
• ✅ HTTPS-only network calls

# Run unit tests
./gradlew test

# Run instrumentation tests
./gradlew connectedAndroidTest

# Run all tests
./gradlew testDebugUnitTest connectedDebugAndroidTest

• App size: < 50 MB
• Cold start: < 2 seconds
• Crash rate: < 1%
• ANR rate: < 0.5%
• Memory usage: < 200 MB

Currently supports:

• English (US)

Planned:

• Spanish
• Hindi
• French

• Phones: Android 7.0+ (API 24+)
• Tablets: 7" and 10" tablets
• Screen sizes: Small to Extra Large
• Orientations: Portrait and Landscape

This is a proprietary project. For internal development team only.

• Follow Kotlin coding conventions
• Write meaningful commit messages
• Create feature branches
• Test before pushing
• Update documentation

Proprietary - All rights reserved

• Developer: [Your Name]
• Designer: [Designer Name]
• Project Manager: [PM Name]

For issues or questions:

• Email: [email protected]
• Documentation: See docs folder
• Firebase Console: [Your Firebase Project]

• ✅ User authentication
• ✅ Content management
• ✅ AI voice assistant
• ✅ Dark/Light mode

• 📝 Quiz system
• 🏆 Achievement badges
• 📈 Progress tracking
• 🔔 Push notifications

• 👥 Social features (study groups)
• 💬 Discussion forums
• 📹 Live sessions
• 💰 Premium subscription

• 100+ downloads
• 4.0+ star rating
• 30% D1 retention
• <1% crash rate

• 1,000+ active users
• 4.5+ star rating
• 50% D7 retention
• Featured in Play Store

Build fails:

./gradlew clean
./gradlew build --refresh-dependencies

Firebase not working:

• Verify google-services.json is in app/ directory
• Check Firebase project configuration
• Ensure SHA-1 fingerprint is added

API key issues:

• Check local.properties has correct key
• Sync Gradle files
• Rebuild project

• Android Developer Guide
• Jetpack Compose Tutorial
• Firebase Documentation
• Kotlin Coroutines Guide
• Material Design 3

• Planning complete
• Development in progress
• Testing phase
• Beta release
• Production release

• Initial release
• Core features implementation
• Play Store launch

Built with ❤️ for CS learners worldwide

For detailed implementation instructions, start with QUICK_START.md