# print-shijay/soilsync---farm-management-information-system architecture

> Architecture diagram of the GitHub repository print-shijay/soilsync---farm-management-information-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/print-shijay/soilsync---farm-management-information-system
- Repository: https://github.com/print-shijay/soilsync---farm-management-information-system

## Overview

This is a mobile farm-management app: users sign in, manage farms and their operational records, and use planning, layout, weather, crop, and collaboration features. The graph highlights the home dashboard and several documented domain branches, with local/cloud persistence as an internal layer. Source excerpts show some dashboard, authentication, team, crop, and persistence calls; many other feature screens are represented from the tree, so their connections are dashed and unverified.

Main entry points: [`app/farm/[id].tsx`](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/farm/%5Bid%5D.tsx) (Farm records), [`app/(tabs)/index.tsx`](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/(tabs)/index.tsx) (Farm dashboard), [`lib/db-operations.ts`](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/db-operations.ts) (Farm data operations), [`lib/AuthContext.tsx`](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/AuthContext.tsx) (Auth state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_auth["Auth state<br/>[AuthContext.tsx]"]
  node_login["Sign in<br/>[login.tsx]"]
end

subgraph group_farm_ops["Farm operations"]
  node_dashboard["Farm dashboard<br/>[index.tsx]"]
  node_farm_detail["Farm records<br/>[&#91;id&#93;.tsx]"]
  node_daily_reports["Daily reports<br/>[useDailyReports.ts]"]
  node_facilities["Facilities<br/>[detail.tsx]"]
end

subgraph group_planning["Planning tools"]
  node_crop_planner["Crop planning<br/>[crop-planner.ts]"]
  node_custom_crops["Custom crops<br/>[index.tsx]"]
  node_farm_layout["Layout designer<br/>[DesignerCanvas.tsx]"]
  node_estate_canvas["Estate layout"]
  node_layout_storage["Layout persistence<br/>[db.ts]"]
  node_detector["Crop detection"]
  node_weather["Weather data<br/>[weather-service.ts]"]
end

subgraph group_collaboration["Collaboration"]
  node_teams["Teams<br/>[index.tsx]"]
  node_team_ops["Team operations<br/>[team-operations.ts]"]
  node_folders["User folders<br/>[index.tsx]"]
  node_announcements["Announcements<br/>[index.tsx]"]
  node_learning["Learning modules<br/>[modules.tsx]"]
end

subgraph group_data["Data services"]
  node_db_ops["Farm data operations<br/>[db-operations.ts]"]
  node_local_db[("Local database<br/>[local-db.ts]")]
  node_powersync[("Offline sync<br/>[powersync.ts]")]
  node_supabase[("Supabase services<br/>[supabase.ts]")]
  node_sync["Sync orchestration<br/>[sync.ts]"]
end

node_user(("Farm user"))

node_user -.->|"signs in"| node_login
node_user -.->|"views"| node_dashboard
node_login -.->|"uses session"| node_auth
node_auth -->|"initializes database"| node_sync
node_auth -->|"disconnects"| node_powersync
node_dashboard -->|"loads farm data"| node_db_ops
node_dashboard -->|"requests sync"| node_sync
node_dashboard -->|"fetches weather"| node_weather
node_custom_crops -->|"manages crops"| node_crop_planner
node_teams -->|"creates teams"| node_team_ops
node_db_ops -->|"uses database"| node_local_db
node_db_ops -->|"loads crop details"| node_crop_planner
node_local_db -->|"opens database"| node_powersync
node_powersync -->|"uploads changes"| node_supabase
node_team_ops -->|"uses farm data"| node_db_ops
node_team_ops -->|"uses service"| node_supabase
node_farm_detail -.->|"supports reporting"| node_daily_reports
node_farm_detail -.->|"manages facilities"| node_facilities
node_farm_detail -.->|"opens layouts"| node_farm_layout
node_farm_layout -.->|"persists layout"| node_layout_storage
node_estate_canvas -.->|"persists estate"| node_layout_storage
node_farm_detail -.->|"uses detection"| node_detector
node_user -.->|"organizes records"| node_folders
node_user -.->|"views updates"| node_announcements
node_user -.->|"studies modules"| node_learning

click node_auth "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/AuthContext.tsx"
click node_login "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/auth/login.tsx"
click node_dashboard "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/(tabs)/index.tsx"
click node_farm_detail "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/farm/%5Bid%5D.tsx"
click node_daily_reports "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/daily-reports/hooks/useDailyReports.ts"
click node_facilities "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/farm/facilities/detail.tsx"
click node_crop_planner "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/crop-planner.ts"
click node_custom_crops "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/custom-crops/index.tsx"
click node_farm_layout "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/farm-layout-designer/components/DesignerCanvas.tsx"
click node_estate_canvas "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/farm-layout-designer/components/EstateDesignerCanvas.tsx"
click node_layout_storage "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/farm-layout-designer/db.ts"
click node_detector "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/yolo-detector/detectionPipeline.ts"
click node_weather "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/weather-service.ts"
click node_teams "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/teams/index.tsx"
click node_team_ops "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/team-operations.ts"
click node_folders "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/user-folders/index.tsx"
click node_announcements "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/announcements/index.tsx"
click node_learning "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/farming-module/modules.tsx"
click node_db_ops "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/db-operations.ts"
click node_local_db "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/local-db.ts"
click node_powersync "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/powersync.ts"
click node_supabase "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/supabase.ts"
click node_sync "https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/sync.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth,node_login,node_user toneBlue
class node_dashboard,node_farm_detail,node_daily_reports,node_facilities toneAmber
class node_crop_planner,node_custom_crops,node_farm_layout,node_estate_canvas,node_layout_storage,node_detector,node_weather toneMint
class node_teams,node_team_ops,node_folders,node_announcements,node_learning toneRose
class node_db_ops,node_local_db,node_powersync,node_supabase,node_sync toneIndigo
```

## Components

### Identity

- [Auth state](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/AuthContext.tsx): `lib/AuthContext.tsx`
- [Sign in](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/auth/login.tsx): `app/auth/login.tsx`

### Farm operations

- [Farm dashboard](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/(tabs)/index.tsx): `app/(tabs)/index.tsx`
- [Farm records](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/farm/%5Bid%5D.tsx): `app/farm/[id].tsx`
- [Daily reports](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/daily-reports/hooks/useDailyReports.ts): `modules/daily-reports/hooks/useDailyReports.ts`
- [Facilities](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/farm/facilities/detail.tsx): `app/farm/facilities/detail.tsx`

### Planning tools

- [Crop planning](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/crop-planner.ts): `lib/crop-planner.ts`
- [Custom crops](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/custom-crops/index.tsx): `app/custom-crops/index.tsx`
- [Layout designer](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/farm-layout-designer/components/DesignerCanvas.tsx): `modules/farm-layout-designer/components/DesignerCanvas.tsx`
- [Estate layout](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/farm-layout-designer/components/EstateDesignerCanvas.tsx): `modules/farm-layout-designer/components/EstateDesignerCanvas.tsx`
- [Layout persistence](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/farm-layout-designer/db.ts): `modules/farm-layout-designer/db.ts`
- [Crop detection](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/modules/yolo-detector/detectionPipeline.ts): `modules/yolo-detector/detectionPipeline.ts`
- [Weather data](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/weather-service.ts): `lib/weather-service.ts`

### Collaboration

- [Teams](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/teams/index.tsx): `app/teams/index.tsx`
- [Team operations](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/team-operations.ts): `lib/team-operations.ts`
- [User folders](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/user-folders/index.tsx): `app/user-folders/index.tsx`
- [Announcements](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/announcements/index.tsx): `app/announcements/index.tsx`
- [Learning modules](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/app/farming-module/modules.tsx): `app/farming-module/modules.tsx`

### Data services

- [Farm data operations](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/db-operations.ts): `lib/db-operations.ts`
- [Local database](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/local-db.ts): `lib/local-db.ts`
- [Offline sync](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/powersync.ts): `lib/powersync.ts`
- [Supabase services](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/supabase.ts): `lib/supabase.ts`
- [Sync orchestration](https://github.com/print-shijay/soilsync---farm-management-information-system/blob/main/lib/sync.ts): `lib/sync.ts`

### Other components

- **Farm user**

## Connections

- Farm user → Sign in: signs in
- Farm user → Farm dashboard: views
- Sign in → Auth state: uses session
- Auth state → Sync orchestration: initializes database (evidence: `lib/AuthContext.tsx`)
- Auth state → Offline sync: disconnects (evidence: `lib/AuthContext.tsx`)
- Farm dashboard → Farm data operations: loads farm data (evidence: `app/(tabs)/index.tsx`)
- Farm dashboard → Sync orchestration: requests sync (evidence: `app/(tabs)/index.tsx`)
- Farm dashboard → Weather data: fetches weather (evidence: `app/(tabs)/index.tsx`)
- Custom crops → Crop planning: manages crops (evidence: `app/custom-crops/index.tsx`)
- Teams → Team operations: creates teams (evidence: `app/teams/index.tsx`)
- Farm data operations → Local database: uses database (evidence: `lib/db-operations.ts`)
- Farm data operations → Crop planning: loads crop details (evidence: `lib/db-operations.ts`)
- Local database → Offline sync: opens database (evidence: `lib/local-db.ts`)
- Offline sync → Supabase services: uploads changes (evidence: `lib/powersync.ts`)
- Team operations → Farm data operations: uses farm data (evidence: `lib/team-operations.ts`)
- Team operations → Supabase services: uses service (evidence: `lib/team-operations.ts`)
- Farm records → Daily reports: supports reporting
- Farm records → Facilities: manages facilities
- Farm records → Layout designer: opens layouts
- Layout designer → Layout persistence: persists layout
- Estate layout → Layout persistence: persists estate
- Farm records → Crop detection: uses detection
- Farm user → User folders: organizes records
- Farm user → Announcements: views updates
- Farm user → Learning modules: studies modules
