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:

Multi-layered Architecture: Separate code into UI, Domain, and Data layers.
Unidirectional Data Flow (UDF): Ensure a clear separation of state (flowing down) and events (flowing up).
Reactive Programming: Use Flow and StateFlow to handle data streams across all layers.
Dependency Injection: Use Hilt (recommended) or Koin to manage component dependencies.
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.