# afxs1114/bfpc-spm2 architecture

> Architecture diagram of the GitHub repository afxs1114/bfpc-spm2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/afxs1114/bfpc-spm2
- Repository: https://github.com/afxs1114/bfpc-spm2

## Overview

This is a React Native fish-market tracking app for recording local fish prices and viewing market conditions and reports. Users move among Home, Market, Reports, and Settings; price entry is opened through shared modal state, while Home also manages species and bagoong records. Screens and forms access Supabase directly through the shared client. The graph preserves the indexed older screen copies and other core modules, but their detailed behavior and some Settings capabilities were not excerpted; those relationships are therefore limited to documented imports.

Main entry points: [`App.js`](https://github.com/afxs1114/bfpc-spm2/blob/main/App.js) (App shell), [`src/theme/theme.js`](https://github.com/afxs1114/bfpc-spm2/blob/main/src/theme/theme.js) (Theme tokens), [`src/screens/HomeScreen.js`](https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/HomeScreen.js) (Home dashboard), [`src/components/RecordPriceModal.js`](https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/RecordPriceModal.js) (Record price form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_app["App shell<br/>[App.js]"]
  node_tabs["Custom tab bar<br/>[CustomTabBar.js]"]
  node_settings["Settings<br/>[SettingsScreen.js]"]
  node_settings_copy["Older settings"]
end

subgraph group_market["Market tracking"]
  node_home["Home dashboard<br/>[HomeScreen.js]"]
  node_home_copy["Older home screen<br/>[HomeScreen copy.js]"]
  node_market_screen["Market analytics<br/>[MarketScreen.js]"]
  node_reports["Daily reports<br/>[ReportsScreen.js]"]
end

subgraph group_records["Records and catalog"]
  node_price_modal["Record price form"]
  node_add_species["Add species<br/>[AddSpeciesModal.js]"]
  node_species_library["Species library"]
  node_bagoong["Bagoong records<br/>[BagoongModal.js]"]
end

subgraph group_shared["Shared infrastructure"]
  node_price_context["Price modal state"]
  node_supabase_client["Supabase client<br/>[supabase.js]"]
  node_theme["Theme tokens<br/>[theme.js]"]
end

node_user(("App user"))
node_supabase_service[("Supabase service")]

node_user -->|"opens"| node_app
node_app -->|"routes"| node_home
node_app -->|"routes"| node_market_screen
node_app -->|"routes"| node_reports
node_app -->|"routes"| node_settings
node_app -->|"renders"| node_tabs
node_app -->|"provides state"| node_price_context
node_app -->|"renders"| node_price_modal
node_price_modal -->|"reads state"| node_price_context
node_home -->|"opens"| node_add_species
node_home -->|"opens"| node_species_library
node_home -->|"opens"| node_bagoong
node_add_species -->|"writes species"| node_supabase_service
node_species_library -->|"reads and deletes"| node_supabase_service
node_price_modal -->|"writes transactions"| node_supabase_service
node_bagoong -->|"writes records"| node_supabase_service
node_home -->|"queries market data"| node_supabase_service
node_home_copy -->|"queries market data"| node_supabase_service
node_market_screen -->|"queries and subscribes"| node_supabase_service
node_reports -->|"queries reports"| node_supabase_service
node_settings -->|"uses data service"| node_supabase_service
node_settings_copy -->|"uses data service"| node_supabase_service
node_supabase_client -->|"configures access"| node_supabase_service
node_home -->|"uses styling"| node_theme
node_market_screen -->|"uses styling"| node_theme
node_reports -->|"uses styling"| node_theme
node_settings -->|"uses styling"| node_theme
node_settings_copy -->|"uses styling"| node_theme
node_tabs -->|"uses modal state"| node_price_context
node_add_species -->|"uses styling"| node_theme
node_species_library -->|"uses styling"| node_theme
node_bagoong -->|"uses styling"| node_theme
node_price_modal -->|"uses styling"| node_theme
node_supabase_client -->|"persists sessions"| node_supabase_service

click node_app "https://github.com/afxs1114/bfpc-spm2/blob/main/App.js"
click node_tabs "https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/CustomTabBar.js"
click node_home "https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/HomeScreen.js"
click node_home_copy "https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/HomeScreen%20copy.js"
click node_market_screen "https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/MarketScreen.js"
click node_reports "https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/ReportsScreen.js"
click node_settings "https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/SettingsScreen.js"
click node_settings_copy "https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/SettingsScreen%20copy.js"
click node_price_context "https://github.com/afxs1114/bfpc-spm2/blob/main/src/context/RecordPriceContext.js"
click node_price_modal "https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/RecordPriceModal.js"
click node_add_species "https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/AddSpeciesModal.js"
click node_species_library "https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/SpecieLibraryModal.js"
click node_bagoong "https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/BagoongModal.js"
click node_supabase_client "https://github.com/afxs1114/bfpc-spm2/blob/main/src/lib/supabase.js"
click node_theme "https://github.com/afxs1114/bfpc-spm2/blob/main/src/theme/theme.js"

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_app,node_tabs,node_settings,node_settings_copy,node_user toneBlue
class node_home,node_home_copy,node_market_screen,node_reports,node_supabase_service toneAmber
class node_price_modal,node_add_species,node_species_library,node_bagoong toneMint
class node_price_context,node_supabase_client,node_theme toneRose
```

## Components

### App navigation

- [App shell](https://github.com/afxs1114/bfpc-spm2/blob/main/App.js): `App.js`
- [Custom tab bar](https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/CustomTabBar.js): `src/components/CustomTabBar.js`
- [Settings](https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/SettingsScreen.js): `src/screens/SettingsScreen.js`
- [Older settings](https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/SettingsScreen%20copy.js): `src/screens/SettingsScreen copy.js`

### Market tracking

- [Home dashboard](https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/HomeScreen.js): `src/screens/HomeScreen.js`
- [Older home screen](https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/HomeScreen%20copy.js): `src/screens/HomeScreen copy.js`
- [Market analytics](https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/MarketScreen.js): `src/screens/MarketScreen.js`
- [Daily reports](https://github.com/afxs1114/bfpc-spm2/blob/main/src/screens/ReportsScreen.js): `src/screens/ReportsScreen.js`

### Records and catalog

- [Record price form](https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/RecordPriceModal.js): `src/components/RecordPriceModal.js`
- [Add species](https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/AddSpeciesModal.js): `src/components/AddSpeciesModal.js`
- [Species library](https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/SpecieLibraryModal.js): `src/components/SpecieLibraryModal.js`
- [Bagoong records](https://github.com/afxs1114/bfpc-spm2/blob/main/src/components/BagoongModal.js): `src/components/BagoongModal.js`

### Shared infrastructure

- [Price modal state](https://github.com/afxs1114/bfpc-spm2/blob/main/src/context/RecordPriceContext.js): `src/context/RecordPriceContext.js`
- [Supabase client](https://github.com/afxs1114/bfpc-spm2/blob/main/src/lib/supabase.js): `src/lib/supabase.js`
- [Theme tokens](https://github.com/afxs1114/bfpc-spm2/blob/main/src/theme/theme.js): `src/theme/theme.js`

### Other components

- **App user**
- **Supabase service**

## Connections

- App user → App shell: opens (evidence: `App.js`)
- App shell → Home dashboard: routes (evidence: `App.js`)
- App shell → Market analytics: routes (evidence: `App.js`)
- App shell → Daily reports: routes (evidence: `App.js`)
- App shell → Settings: routes (evidence: `App.js`)
- App shell → Custom tab bar: renders (evidence: `App.js`)
- App shell → Price modal state: provides state (evidence: `App.js`)
- App shell → Record price form: renders (evidence: `App.js`)
- Record price form → Price modal state: reads state (evidence: `src/components/RecordPriceModal.js`)
- Home dashboard → Add species: opens (evidence: `src/screens/HomeScreen.js`)
- Home dashboard → Species library: opens (evidence: `src/screens/HomeScreen.js`)
- Home dashboard → Bagoong records: opens (evidence: `src/screens/HomeScreen.js`)
- Add species → Supabase service: writes species (evidence: `src/components/AddSpeciesModal.js`)
- Species library → Supabase service: reads and deletes (evidence: `src/components/SpecieLibraryModal.js`)
- Record price form → Supabase service: writes transactions (evidence: `src/components/RecordPriceModal.js`)
- Bagoong records → Supabase service: writes records (evidence: `src/components/BagoongModal.js`)
- Home dashboard → Supabase service: queries market data (evidence: `src/screens/HomeScreen.js`)
- Older home screen → Supabase service: queries market data (evidence: `src/screens/HomeScreen copy.js`)
- Market analytics → Supabase service: queries and subscribes (evidence: `src/screens/MarketScreen.js`)
- Daily reports → Supabase service: queries reports (evidence: `src/screens/ReportsScreen.js`)
- Settings → Supabase service: uses data service (evidence: `src/screens/SettingsScreen.js`)
- Older settings → Supabase service: uses data service (evidence: `src/screens/SettingsScreen copy.js`)
- Supabase client → Supabase service: configures access (evidence: `src/lib/supabase.js`)
- Home dashboard → Theme tokens: uses styling (evidence: `src/screens/HomeScreen.js`)
- Market analytics → Theme tokens: uses styling (evidence: `src/screens/MarketScreen.js`)
- Daily reports → Theme tokens: uses styling (evidence: `src/screens/ReportsScreen.js`)
- Settings → Theme tokens: uses styling (evidence: `src/screens/SettingsScreen.js`)
- Older settings → Theme tokens: uses styling (evidence: `src/screens/SettingsScreen copy.js`)
- Custom tab bar → Price modal state: uses modal state (evidence: `src/components/CustomTabBar.js`)
- Add species → Theme tokens: uses styling (evidence: `src/components/AddSpeciesModal.js`)
- Species library → Theme tokens: uses styling (evidence: `src/components/SpecieLibraryModal.js`)
- Bagoong records → Theme tokens: uses styling (evidence: `src/components/BagoongModal.js`)
- Record price form → Theme tokens: uses styling (evidence: `src/components/RecordPriceModal.js`)
- Supabase client → Supabase service: persists sessions (evidence: `src/lib/supabase.js`)
