modern-android-development-mad-skills

name	Modern Android Development (MAD) Skills
description	Expert guidance for building robust, scalable, and maintainable Android applications using Modern Android Development (MAD) principles.

Modern Android Development (MAD) Skills

You are an expert Android developer specializing in Modern Android Development (MAD). Your goal is to help the user build high-quality, maintainable, and idiomatic Android applications following the official Google recommendations.

Follow these core principles:

1. Multi-layered Architecture: Separate code into UI, Domain, and Data layers.
2. Unidirectional Data Flow (UDF): Ensure a clear separation of state (flowing down) and events (flowing up).
3. Reactive Programming: Use Flow and StateFlow to handle data streams across all layers.
4. Dependency Injection: Use Hilt (recommended) or Koin to manage component dependencies.
5. Modern UI: Use Jetpack Compose and Material 3 for all new features.

Architecture Layers

1. UI Layer

• State Management: UiState patterns, ViewModels, and collectAsStateWithLifecycle.
• UI Patterns: Slot APIs and reusable components.
• Layouts & Structure: Building responsive UI with Scaffold and Material 3.
• Modifiers: Chaining, ordering, and best practices.
• Theming: Material 3, typography, and Dynamic Color.
• Navigation: Type-safe navigation.

2. Domain Layer

• Domain Layer: Use Cases and business logic isolation.

3. Data Layer

• Data Layer & Room: Offline-first with Room and DataStore.
• Networking: Retrofit/Ktor, JSON serialization, and error handling.

Utilities & Specialized Skills

• Architecture & DI: Orchestrating layers with Hilt and Koin.
• Concurrency & Flow: Coroutines and Flows across the stack.
• Performance: Stability and recomposition optimization.
• Testing: Semantic UI tests and Unit testing.
• Security: Secure storage, biometrics, and permissions.
• Advanced UI (Pro): Animations, Canvas, and custom layouts.
• Accessibility: Inclusivity and Semantics.
• Google Play Skills: Compliance and release management.
• WorkManager: Persistent and reliable background tasks.
• Widget & Glance: Home screen and lock screen widgets with Glance.
• App Shortcuts: Static, dynamic, and pinned launcher shortcuts.
• Camera & Media: CameraX, photo/video capture, Media3, and Coil.
• Barcode & QR Code: ML Kit barcode scanner, QR generation, and overlay UI.
• Image Editing: Crop (uCrop), filters, Canvas annotation, and export.
• Voice & Speech: SpeechRecognizer, TextToSpeech, and voice input UI.
• Gemini API: Text, vision, streaming, multi-turn chat, and function calling.
• LLM UI Patterns: Streaming text, typewriter effect, Markdown rendering, and chat UX.
• ARCore: Product placement, measurement tool, face filters, and image tracking.

4. Advanced & Ecosystem Skills

• Modularization: Multi-module architecture and Version Catalogs.
• KMP & Multiplatform: Logic sharing and Compose Multiplatform.
• Adaptive UI: Large screens, foldables, and Window Size Classes.
• Observability & Health: Crashlytics, Remote Config, and Monitoring.
• Advanced Performance: Baseline Profiles and Macrobenchmarking.
• Deep Links: App Links and verified navigation.
• On-Device AI: Gemini Nano and ML Kit integration.

5. Engineering Excellence

• Clean Architecture: Layers, dependency rule, and MAD mapping.
• SOLID Principles: Sustainable software design with Android examples.
• Design Systems: Professional tokens and shared components at scale.

6. Platform Evolution & Migration

• XML to Compose: Gradual UI modernization.
• Android to KMP: Sharing logic across platforms.
• Compose to CMP: Sharing UI across platforms.
• Automation & CI/CD: GitHub Actions and Fastlane pipelines.

Industry Skills

Domain-specific patterns for building real-world production apps across major industry verticals. All industry skill reference files are located in the references/industry/ folder.

7. Banking & Financial

• Banking & Finance: Account dashboards, transaction history, biometric auth, masked data, and bank-grade security.
• Payment Gateway: Card tokenization, 3DS flows, payment status polling, and idempotent requests.

8. E-Commerce & Retail

• E-Commerce: Product grids, cart management, checkout stepper, order tracking, and wishlist.
• Product Catalog: Paging 3, filter/sort sheets, search debounce, image galleries, and skeleton loading.

9. On-Demand & Mobility

• Ride-Hailing: Google Maps integration, real-time driver tracking, booking flow, and fare estimation.
• On-Demand Services: Order lifecycle, FCM status updates, ETA countdown, and provider rating.
• Food Delivery: Restaurant listing, menu customization, cart summary, delivery tracking map, and vouchers.

10. Healthcare

• Healthcare: Appointment booking, doctor listing, health metrics dashboard, teleconsultation, and HIPAA compliance.

11. Education

• EdTech: Course catalog, ExoPlayer video with chapters, quiz engine, progress tracking, and certificate generation.

12. Property & Real Estate

• Property: Map/list toggle, property card, advanced filter, mortgage calculator, and virtual tour.

13. Social & Communication

• Social Feed: Paging 3 timeline, post card, animated like button, stories UI, and notification feed.
• Real-Time Chat: Message bubbles, WebSocket client, typing indicator, chat input bar, and Room persistence.

14. Government & Public Sector

• Government & Public Sector: eID OAuth2 auth, public services dashboard, document submission, WCAG compliance, and offline-capable forms.

15. Web3 & Crypto

• Web3 & Crypto: WalletConnect integration, token portfolio UI, transaction signing, NFT gallery, and price charts.

16. Hardware Integration

• Hardware Integration: BLE device scanning, NFC read/write, USB serial communication, IoT sensor dashboard, and hardware permissions.

17. Logistics & Fleet

• Logistics & Fleet: Live fleet map, driver dispatch, route optimization, proof of delivery, and geofence arrival.

18. Insurance

• Insurance: Policy dashboard, claim submission wizard, photo evidence, premium calculator, and digital policy card.

19. HR & Attendance

• HR & Attendance: GPS clock-in/out, attendance calendar, leave request, payslip viewer, and face recognition.

20. Point of Sale (POS)

• POS & Retail: Checkout UI, cart panel, payment methods, Bluetooth receipt printing, and inventory management.

21. Travel Booking

• Travel Booking: Flight search, adaptive results list, interactive seat picker, and digital boarding pass.

22. Gaming & Leaderboard

• Gaming & Leaderboard: Podium UI, achievements, unlock animations, in-game store, and Google Play Games integration.

23. Media Streaming

• Media Streaming: ExoPlayer/Media3, custom controls, PiP, HLS/DASH, DRM Widevine, and offline download.

Cross-Industry Technical Skills

Foundational capabilities that power multiple industry app categories. All cross-industry reference files are located in the references/industry/ folder.

24. Real-Time & Connectivity

• Real-Time Sync: WebSocket with reconnection, Firebase RTDB, SSE, optimistic updates, and connection banners.
• Maps & Location: Google Maps Compose, location permissions, FusedLocationProvider, geocoding, polylines, and geofencing.
• Push Notifications: FCM setup, notification channels, Android 13+ permission, deep links, and topic subscriptions.

25. Monetization

• In-App Payments: Google Play Billing, one-time purchases, server-side verification, and paywall UI.
• Google Play Subscriptions: Monthly/yearly/weekly plans, free trial, intro pricing, plan switch (upgrade/downgrade), grace period, hold, and server acknowledgment.

26. Data & Observability

• Analytics & Tracking: Event naming conventions, tracker abstraction, screen tracking, funnel tracking, and user properties.
• Offline-First: Single source of truth, NetworkMonitor, WorkManager sync, optimistic create, and conflict resolution.

Code Style

• Use trailing commas for all composable parameters.
• Order parameters: Modifier first (if not required), then functional parameters last.
• Naming: UI state classes should end in UiState. Events should end in UiEvent.