# absknpl/docu-manage-mobile-app architecture

> Architecture diagram of the GitHub repository absknpl/docu-manage-mobile-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/absknpl/docu-manage-mobile-app
- Repository: https://github.com/absknpl/docu-manage-mobile-app

## Overview

##### Project type and purpose
- Arkive is a cross-platform mobile app built with React Native and Expo for managing documents locally on a device.
- It’s a single mobile client (no separate backend server) that uses Context API for state, native modules (notification, share) for platform services, and Expo as its runtime.

##### File structure
- App.js at root is the entry point: it wires up all Context providers and loads the root navigator.
- /navigation contains AppNavigator.js and BottomTabNavigator.js: defines stack & tab flows.
- /screens holds the main UI containers (DocumentsScreen, TimelineScreen, SettingsScreen, NotificationsScreen, OnboardingScreen).
- /components holds reusable pieces (cards, lists, buttons, animations).
- /contexts defines global state managers: DocumentsContext, OnboardingContext, NotificationSettingsContext, ThemeContext.
- /utils has onboarding and notification-scheduling logic.
- Configuration: app.json, eas.json for Expo/EAS builds; package.json for dependencies.

##### Key architectural patterns
- Context API for global state separation (documents, theming, onboarding, notifications).
- Navigation layer: a root Tab navigator plus modal stacks for screens like upload or document viewer.
- Component‐based UI: screens compose small, stateless or stateful components.
- Utility modules for side effects (scheduling notifications, engagement logic).
- Expo provides native bindings (notifications, share sheet, asset bundling).

##### Main components and their interactions
a. Native Platform (iOS/Android)
– Hosts the Expo runtime
– Provides native services: Notifications, Share Sheet, File Picker
b. Expo Runtime
– Bridges React Native JS code to native modules
– Manages asset loading, development workflow
c. App.js (Root)
– Wraps Context Providers in this order: ThemeContext → NotificationSettingsContext → DocumentsContext → OnboardingContext
– Renders AppNavigator
d. Navigation Layer
– BottomTabNavigator: Documents, Timeline, Notifications, Settings
– Stack/Modal Navigator: Onboarding flow and UploadModal overlay
– OnboardingScreen appears conditionally via OnboardingContext
e. Screens
– DocumentsScreen: lists documents via DocumentList → DocumentCard components
– TimelineScreen: TimelineView → TimelineItem components
– NotificationsScreen: shows pending & delivered notifications (uses NotificationSettingsContext)
– SettingsScreen: controls theme & notification preferences (updates ThemeContext, NotificationSettingsContext)
– OnboardingScreen: uses OnboardingContext, animated MascotAnimation & OnboardingStep components
f. Contexts
– DocumentsContext: in-memory/document CRUD, persists to AsyncStorage (implied), triggers notifications scheduling on changes
– NotificationSettingsContext: holds user preferences, feeds into engagementNotification utility
– ThemeContext: light/dark/pop modes, consumed by styled components
– OnboardingContext: tracks new‐user flow, completion flag
g. Utils & Services
– engagementNotification.js: schedules/reschedules OS notifications via Expo Notifications API
– onboardingData.js: drives the OnboardingScreen steps
h. Assets

## Diagram (Mermaid)

```mermaid
flowchart TB
  subgraph "Layer 1: Native & Runtime"
    NP["Native Platform (iOS & Android)"]:::gray
    ER["Expo Runtime"]:::gray
  end
  NP --> ER

  subgraph "Layer 2: Entry Point & State Management"
    A["App.js"]:::state
    C1["ThemeContext"]:::state
    C2["NotificationSettingsContext"]:::state
    C3["DocumentsContext"]:::state
    C4["OnboardingContext"]:::state
  end
  ER --> A
  A --> C1 --> C2 --> C3 --> C4

  subgraph "Layer 3: UI Layer"
    subgraph Navigation
      AN["AppNavigator"]:::ui
      BTN["BottomTabNavigator"]:::ui
    end
    subgraph Screens
      S1["DocumentsScreen"]:::ui
      S2["TimelineScreen"]:::ui
      S3["NotificationsScreen"]:::ui
      S4["SettingsScreen"]:::ui
      S5["OnboardingScreen"]:::ui
    end
    subgraph Components
      Comp1["DocumentList"]:::ui
      Comp2["DocumentCard"]:::ui
      Comp3["DocumentViewer"]:::ui
      Comp4["TimelineView"]:::ui
      Comp5["TimelineItem"]:::ui
      Comp6["UploadModal"]:::ui
      Comp7["OnboardingStep"]:::ui
      Comp8["MascotAnimation"]:::ui
      Comp9["CelebrationAnimation"]:::ui
      Comp10["FloatingActionButton"]:::ui
      Comp11["SearchBar"]:::ui
    end
  end

  A --> AN --> BTN
  BTN --> S1
  BTN --> S2
  BTN --> S3
  BTN --> S4
  C4 --> S5
  S1 --> Comp1
  S1 --> Comp2
  S1 --> Comp3
  S2 --> Comp4
  S2 --> Comp5
  S3 --> C2
  S4 --> C1
  S5 --> Comp7
  S5 --> Comp8
  S5 --> Comp9
  Comp10 --> Comp6
  S1 --> Comp11

  subgraph "Layer 4: Services & Assets"
    U1["engagementNotification.js"]:::service
    U2["onboardingData.js"]:::service
    NM1["Notifications Module"]:::gray
    NM2["Share Sheet Module"]:::gray
    NM3["File Picker Module"]:::gray
    AS1["celebration.json"]:::asset
    AS2["mascot-cheer.json, mascot-neutral.json, mascot-nod.json, mascot-smile.json, mascot-wave.json"]:::asset
    CFG1["app.json, eas.json, package.json"]:::config
  end

  Comp1 -.-> U1
  Comp2 -.-> U1
  U1 --> NM1
  U1 --> C3
  U1 --> C2
  U2 --> S5
  U2 --> C4
  ER --> NM1
  ER --> NM2
  ER --> NM3

  classDef ui fill:#E0F7FA,stroke:#00838F
  classDef state fill:#E8F5E9,stroke:#2E7D32
  classDef service fill:#FFF3E0,stroke:#EF6C00
  classDef gray fill:#F5F5F5,stroke:#9E9E9E
  classDef asset fill:#ECEFF1,stroke:#546E7A
  classDef config fill:#D7CCC8,stroke:#5D4037

  click A "https://github.com/absknpl/docu-manage-mobile-app/blob/main/App.js"
  click AN "https://github.com/absknpl/docu-manage-mobile-app/blob/main/navigation/AppNavigator.js"
  click BTN "https://github.com/absknpl/docu-manage-mobile-app/blob/main/navigation/BottomTabNavigator.js"
  click S1 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/screens/DocumentsScreen.js"
  click S2 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/screens/TimelineScreen.js"
  click S3 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/screens/NotificationsScreen.js"
  click S4 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/screens/SettingsScreen.js"
  click S5 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/screens/OnboardingScreen.js"
  click Comp1 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/DocumentList.js"
  click Comp2 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/DocumentCard.js"
  click Comp3 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/DocumentViewer.js"
  click Comp4 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/TimelineView.js"
  click Comp5 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/TimelineItem.js"
  click Comp6 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/UploadModal.js"
  click Comp7 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/OnboardingStep.js"
  click Comp8 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/MascotAnimation.js"
  click Comp9 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/CelebrationAnimation.js"
  click Comp10 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/FloatingActionButton.js"
  click Comp11 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/components/SearchBar.js"
  click C3 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/contexts/DocumentsContext.js"
  click C2 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/contexts/NotificationSettingsContext.js"
  click C1 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/contexts/ThemeContext.js"
  click C4 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/contexts/OnboardingContext.js"
  click U1 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/utils/engagementNotification.js"
  click U2 "https://github.com/absknpl/docu-manage-mobile-app/blob/main/assets/onboarding/onboardingData.js"
```
