README.md

Jetpack Common - Architecture & Patterns

A centralized knowledge base of architectural patterns and reusable UI components used across the Essentials and AirSync projects.

Contents

• ui/: User interface components and layout strategies.
  • layout/: High-level screen structures and animations.
    • Edge-to-Edge Guide
    • Splash Screen Pattern
    • Welcome & Onboarding
    • Swipe Navigation Pattern
    • App Menu Shortcuts
    • Progressive Blur Implementation
  • Theming & AMOLED
  • components/: Reusable Material 3 components.
    • Containers: Layout wrappers.
      • Rounded Card Container
    • Cards & Items: List items and feature cards.
      • List Item Variants
    • About & Community: App info and developer credits.
    • Bottom Sheets: Modal overlays and guides.
      • General Layout
      • Help & Guides
      • Feature Info
    • Pickers: Selection components.
      • Segmented Picker Pattern
    • Toolbars: Variants of top and bottom bars.
      • Floating Toolbar
      • Top App Bar
  • theme/: Design system and theming guides.
• logic/: Business logic and utility patterns.
  • search/: Implementation of global search.
    • Deep Search Pattern
  • services/: Background services and system integrations.
    • Quick Settings Tiles
    • Live Update Notifications
    • In-App Updates
  • utils/: Common utility functions.
    • Haptic Feedback
    • Developer Mode
    • Language Switching
    • App Selection Picker
    • Flashlight & Brightness
    • Media Playback Info
    • Shell Command Execution
    • WearOS Communication Logic
    • Full Backup & Restore
    • Cross-App Communication
• wearos/: Specialized WearOS components.
  • Glanceable Tiles
  • System Complications
  • Enhanced Time View
• permissions/: Permission handling strategies.
  • Shizuku Integration
• accessibility/: System-level interaction patterns.
  • Accessibility Overlays
• data/: Data persistence and migration patterns.

Getting Started

Refer to the specific categories to find implementation details and code snippets. This repository serves as the source of truth for the Essentials ecosystem design language.