# tryterra/terra-react architecture

> Architecture diagram of the GitHub repository tryterra/terra-react, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tryterra/terra-react
- Repository: https://github.com/tryterra/terra-react

## Overview

##### Main Components Identification

a) React Native Bridge Layer
- Bridge interface between JavaScript and native platforms
- TerraReactModule.java and TerraReact.swift as native modules

b) Platform-Specific Implementations
- iOS Implementation (Swift/Objective-C)
- Android Implementation (Java)

c) Core SDK Features
- Activity Tracking
- Data Models
- Enumeration Types

##### Component Relationships

**[React Native Application Layer]**
- ↕
**[Terra React Native Bridge]**
- ↕
- ┌──────┴──────┐
**[iOS Native]  [Android Native]**

- ┬───────┘
**[Terra Backend Services]**

##### Detailed Component Breakdown

Specific elements:

a) Data Models Section:
- Activity Models
- Sample Data Types (Heart Rate, Steps, etc.)
- Relationship with enums

b) Native Implementation Details:
- iOS: TerraReact.swift
- Android: TerraReactModule.java

##### Important Elements to Highlight

a) Data Flow Patterns:
- How activity data flows from device sensors
- Data transformation points
- API integration points

b) Module Organization:
- Related enums (ActivityTypes, Permissions, etc.)
- Sample data type hierarchy
- Bridge communication paths

##### Technical Details

- Native module registration process
- Event emission pathways
- Data type conversion points
- Permission handling flow

##### Specific Implementation Notes

- Activity tracking implementation
- Health data processing
- Permission management
- Data synchronization

Remember to include:
- Version compatibility indicators
- Platform-specific considerations
- Data flow directionality
- Error handling paths
- Permission requirement flows

This will provide a comprehensive view of how the Terra React Native SDK integrates with both the native platform capabilities and the React Native framework while maintaining clarity about the data flow and processing pipeline.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph RN["React Native Application Layer"]
        JSInterface["JavaScript Interface"]
        Models["Data Models"]
        Enums["Enumeration Types"]
    end

    subgraph Bridge["Terra React Native Bridge"]
        iOSBridge["iOS Bridge"]
        AndroidBridge["Android Bridge"]
        BridgeHeader["Bridge Header"]
    end

    subgraph Native["Native Implementation Layer"]
        direction TB
        subgraph iOS["iOS Native"]
            TerraReactSwift["Terra React Swift"]
            ActivityDataSwift["Activity Data Swift"]
        end
        
        subgraph Android["Android Native"]
            TerraReactModule["Terra React Module"]
            TerraReactPackage["Terra React Package"]
        end
    end

    subgraph DataModels["Data Models & Types"]
        direction TB
        subgraph ActivityModels["Activity Models"]
            Activity["Activity Tracking"]
        end

        subgraph SampleTypes["Sample Data Types"]
            HeartRate["Heart Rate Data"]
            Steps["Steps Data"]
            Calories["Calories Data"]
            Distance["Distance Data"]
        end

        subgraph EnumTypes["Enumeration Categories"]
            ActivityTypes["Activity Types"]
            Permissions["Permissions"]
            HeartRateZones["Heart Rate Zones"]
            ActivityLevels["Activity Levels"]
        end
    end

    Backend["Terra Backend Services"]

    %% Relationships
    JSInterface --> Bridge
    Models --> Bridge
    Enums --> Bridge
    
    Bridge --> iOS
    Bridge --> Android
    
    iOS --> Backend
    Android --> Backend
    
    %% Click Events
    click JSInterface "https://github.com/tryterra/terra-react/blob/master/src/index.ts"
    click iOSBridge "https://github.com/tryterra/terra-react/blob/master/ios/TerraReact.swift"
    click AndroidBridge "https://github.com/tryterra/terra-react/blob/master/android/src/main/java/com/terrareact/TerraReactModule.java"
    click BridgeHeader "https://github.com/tryterra/terra-react/blob/master/ios/TerraReact-Bridging-Header.h"
    click TerraReactSwift "https://github.com/tryterra/terra-react/blob/master/ios/TerraReact.swift"
    click ActivityDataSwift "https://github.com/tryterra/terra-react/blob/master/ios/TerraActivityData.swift"
    click TerraReactModule "https://github.com/tryterra/terra-react/blob/master/android/src/main/java/com/terrareact/TerraReactModule.java"
    click TerraReactPackage "https://github.com/tryterra/terra-react/blob/master/android/src/main/java/com/terrareact/TerraReactPackage.java"
    click Activity "https://github.com/tryterra/terra-react/blob/master/src/models/Activity.ts"
    click Models "https://github.com/tryterra/terra-react/tree/master/src/models/"
    click Enums "https://github.com/tryterra/terra-react/tree/master/src/enums/"
    click HeartRate "https://github.com/tryterra/terra-react/blob/master/src/models/samples/HeartRateDataSample.ts"
    click Steps "https://github.com/tryterra/terra-react/blob/master/src/models/samples/StepSample.ts"
    click Calories "https://github.com/tryterra/terra-react/blob/master/src/models/samples/CalorieSample.ts"
    click Distance "https://github.com/tryterra/terra-react/blob/master/src/models/samples/DistanceSample.ts"
    click ActivityTypes "https://github.com/tryterra/terra-react/blob/master/src/enums/ActivityTypes.ts"
    click Permissions "https://github.com/tryterra/terra-react/blob/master/src/enums/Permissions.ts"
    click HeartRateZones "https://github.com/tryterra/terra-react/blob/master/src/enums/HeartRateZone.ts"
    click ActivityLevels "https://github.com/tryterra/terra-react/blob/master/src/enums/ActivityLevel.ts"

    %% Styling
    classDef default fill:#f9f9f9,stroke:#333,stroke-width:2px
    classDef reactNative fill:#61dafb,stroke:#333,color:#000
    classDef ios fill:#7dba4c,stroke:#333,color:#fff
    classDef android fill:#a4c639,stroke:#333,color:#fff
    classDef data fill:#9c27b0,stroke:#333,color:#fff
    classDef backend fill:#666,stroke:#333,color:#fff
    
    class RN,JSInterface,Models,Enums reactNative
    class iOS,TerraReactSwift,ActivityDataSwift ios
    class Android,TerraReactModule,TerraReactPackage android
    class DataModels,ActivityModels,SampleTypes,EnumTypes,Activity,HeartRate,Steps,Calories,Distance,ActivityTypes,Permissions,HeartRateZones,ActivityLevels data
    class Backend backend
```
