# natalykn/fungiincognita architecture

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

- Interactive diagram: https://gitdiagram.com/natalykn/fungiincognita
- Repository: https://github.com/natalykn/fungiincognita

## Overview

Fungi Incognita is an iOS mushroom guide and identification app. Its main workflow is selecting a library photo, classifying it on-device, and showing the predicted label; separate guide and favorites views browse species reference data. The repository also documents anonymous Firebase authentication, Firestore reference data, cloud image storage, offline help, image caching, search suggestions, and recent search history. The shown code substantiates the classifier, photo selection, Firestore/favorites, and guide-image flow; cloud storage details and several documented capabilities are not visible in sampled implementation, so those links are omitted or marked unverified.

Main entry points: [`Fungi incognita/Fungi Incognita/ContentView.swift`](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/ContentView.swift) (Tab navigation), [`Fungi incognita/Fungi Incognita/Repositories/FungiRepository.swift`](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Repositories/FungiRepository.swift) (Species repository), [`Fungi incognita/Fungi Incognita/FungiShortInfo.swift`](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/FungiShortInfo.swift) (Species details), [`Fungi incognita/Fungi Incognita/Views/IdentificationView.swift`](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/IdentificationView.swift) (Identification view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_content["Tab navigation<br/>[ContentView.swift]"]
  node_tabs["Tab controls<br/>[TabBarItem.swift]"]
end

subgraph group_identify["Photo identification"]
  node_picker["Photo picker<br/>[PhotoPicker.swift]"]
  node_identification["Identification view"]
  node_imageclassifier["Image classifier"]
  node_classifier["Core ML classifier<br/>[Classifier.swift]"]
end

subgraph group_guide["Species guide"]
  node_fungilist["Species list<br/>[FungiesList.swift]"]
  node_fungicard["Species details"]
  node_fungiimage["Species image<br/>[FungiImage.swift]"]
  node_fungimodel["Species record<br/>[Fungi.swift]"]
end

subgraph group_services["Data and services"]
  node_repository["Species repository"]
  node_firestore[("Firestore")]
  node_auth["Anonymous authentication"]
  node_storage[("Firebase image storage")]
  node_favorites[("Favorites persistence")]
end

subgraph group_profile["Profile and help"]
  node_profile["Profile view<br/>[ProfileView.swift]"]
  node_profilesettings["Profile settings"]
  node_info["Info view<br/>[InfoView.swift]"]
  node_about["About information<br/>[About.swift]"]
  node_help["Help information<br/>[Help.swift]"]
  node_answercell["Help answer cell<br/>[AnswerCell.swift]"]
end

node_user(("App user"))

node_user -->|"opens"| node_content
node_content -->|"renders"| node_tabs
node_content -->|"shows"| node_identification
node_content -->|"shows"| node_fungilist
node_content -->|"shows"| node_profile
node_content -->|"shows"| node_info
node_identification -->|"presents"| node_picker
node_identification -->|"submits image"| node_imageclassifier
node_imageclassifier -->|"delegates"| node_classifier
node_fungilist -->|"queries"| node_repository
node_fungilist -->|"renders"| node_fungicard
node_fungicard -->|"renders"| node_fungiimage
node_fungicard -->|"updates favorites"| node_repository
node_fungicard -.->|"loads image"| node_storage
node_repository -->|"reads species"| node_firestore
node_repository -->|"observes user"| node_auth
node_repository -->|"persists favorites"| node_favorites
node_repository -->|"decodes records"| node_fungimodel
node_auth -->|"authenticates"| node_user
node_profile -->|"shows settings"| node_profilesettings
node_info -->|"opens"| node_about
node_info -->|"opens"| node_help
node_help -->|"renders"| node_answercell

click node_content "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/ContentView.swift"
click node_tabs "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/UI/TabBarItem.swift"
click node_picker "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/PhotoPicker.swift"
click node_identification "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/IdentificationView.swift"
click node_imageclassifier "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Classifier/ImageClassifier.swift"
click node_classifier "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Classifier/Classifier.swift"
click node_fungilist "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/FungiesList.swift"
click node_fungicard "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/FungiShortInfo.swift"
click node_fungiimage "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/UI/FungiImage.swift"
click node_fungimodel "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Models/Fungi.swift"
click node_repository "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Repositories/FungiRepository.swift"
click node_auth "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Services/AuthenticationService.swift"
click node_favorites "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Helpers/StorageUserDefaults.swift"
click node_profile "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/ProfileView/ProfileView.swift"
click node_profilesettings "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/ProfileView/SettingsViewForProfile.swift"
click node_info "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/SettingsView/InfoView.swift"
click node_about "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/About.swift"
click node_help "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/Help.swift"
click node_answercell "https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Cells/AnswerCell.swift"

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_content,node_tabs,node_user toneBlue
class node_picker,node_identification,node_imageclassifier,node_classifier toneAmber
class node_fungilist,node_fungicard,node_fungiimage,node_fungimodel toneMint
class node_repository,node_firestore,node_auth,node_storage,node_favorites toneRose
class node_profile,node_profilesettings,node_info,node_about,node_help,node_answercell toneIndigo
```

## Components

### App navigation

- [Tab navigation](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/ContentView.swift): `Fungi incognita/Fungi Incognita/ContentView.swift`
- [Tab controls](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/UI/TabBarItem.swift): `Fungi incognita/Fungi Incognita/UI/TabBarItem.swift`

### Photo identification

- [Photo picker](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/PhotoPicker.swift): `Fungi incognita/Fungi Incognita/Views/PhotoPicker.swift`
- [Identification view](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/IdentificationView.swift): `Fungi incognita/Fungi Incognita/Views/IdentificationView.swift`
- [Image classifier](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Classifier/ImageClassifier.swift): `Fungi incognita/Classifier/ImageClassifier.swift`
- [Core ML classifier](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Classifier/Classifier.swift): `Fungi incognita/Classifier/Classifier.swift`

### Species guide

- [Species list](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/FungiesList.swift): `Fungi incognita/Fungi Incognita/Views/FungiesList.swift`
- [Species details](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/FungiShortInfo.swift): `Fungi incognita/Fungi Incognita/FungiShortInfo.swift`
- [Species image](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/UI/FungiImage.swift): `Fungi incognita/Fungi Incognita/UI/FungiImage.swift`
- [Species record](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Models/Fungi.swift): `Fungi incognita/Fungi Incognita/Models/Fungi.swift`

### Data and services

- [Species repository](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Repositories/FungiRepository.swift): `Fungi incognita/Fungi Incognita/Repositories/FungiRepository.swift`
- **Firestore**
- [Anonymous authentication](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Services/AuthenticationService.swift): `Fungi incognita/Fungi Incognita/Services/AuthenticationService.swift`
- **Firebase image storage**
- [Favorites persistence](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Helpers/StorageUserDefaults.swift): `Fungi incognita/Fungi Incognita/Helpers/StorageUserDefaults.swift`

### Profile and help

- [Profile view](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/ProfileView/ProfileView.swift): `Fungi incognita/Fungi Incognita/ProfileView/ProfileView.swift`
- [Profile settings](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/ProfileView/SettingsViewForProfile.swift): `Fungi incognita/Fungi Incognita/ProfileView/SettingsViewForProfile.swift`
- [Info view](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/SettingsView/InfoView.swift): `Fungi incognita/Fungi Incognita/SettingsView/InfoView.swift`
- [About information](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/About.swift): `Fungi incognita/Fungi Incognita/Views/About.swift`
- [Help information](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Views/Help.swift): `Fungi incognita/Fungi Incognita/Views/Help.swift`
- [Help answer cell](https://github.com/natalykn/fungiincognita/blob/master/Fungi%20incognita/Fungi%20Incognita/Cells/AnswerCell.swift): `Fungi incognita/Fungi Incognita/Cells/AnswerCell.swift`

### Other components

- **App user**

## Connections

- App user → Tab navigation: opens (evidence: `Fungi incognita/Fungi Incognita/ContentView.swift`)
- Tab navigation → Tab controls: renders (evidence: `Fungi incognita/Fungi Incognita/ContentView.swift`)
- Tab navigation → Identification view: shows (evidence: `Fungi incognita/Fungi Incognita/ContentView.swift`)
- Tab navigation → Species list: shows (evidence: `Fungi incognita/Fungi Incognita/ContentView.swift`)
- Tab navigation → Profile view: shows (evidence: `Fungi incognita/Fungi Incognita/ContentView.swift`)
- Tab navigation → Info view: shows (evidence: `Fungi incognita/Fungi Incognita/ContentView.swift`)
- Identification view → Photo picker: presents (evidence: `Fungi incognita/Fungi Incognita/Views/IdentificationView.swift`)
- Identification view → Image classifier: submits image (evidence: `Fungi incognita/Fungi Incognita/Views/IdentificationView.swift`)
- Image classifier → Core ML classifier: delegates (evidence: `Fungi incognita/Classifier/ImageClassifier.swift`)
- Species list → Species repository: queries (evidence: `Fungi incognita/Fungi Incognita/Views/FungiesList.swift`)
- Species list → Species details: renders (evidence: `Fungi incognita/Fungi Incognita/Views/FungiesList.swift`)
- Species details → Species image: renders (evidence: `Fungi incognita/Fungi Incognita/FungiShortInfo.swift`)
- Species details → Species repository: updates favorites (evidence: `Fungi incognita/Fungi Incognita/FungiShortInfo.swift`)
- Species details → Firebase image storage: loads image (evidence: `README.md`)
- Species repository → Firestore: reads species (evidence: `Fungi incognita/Fungi Incognita/Repositories/FungiRepository.swift`)
- Species repository → Anonymous authentication: observes user (evidence: `Fungi incognita/Fungi Incognita/Repositories/FungiRepository.swift`)
- Species repository → Favorites persistence: persists favorites (evidence: `Fungi incognita/Fungi Incognita/Repositories/FungiRepository.swift`)
- Species repository → Species record: decodes records (evidence: `Fungi incognita/Fungi Incognita/Repositories/FungiRepository.swift`)
- Anonymous authentication → App user: authenticates (evidence: `Fungi incognita/Fungi Incognita/Services/AuthenticationService.swift`)
- Profile view → Profile settings: shows settings (evidence: `Fungi incognita/Fungi Incognita/ProfileView/ProfileView.swift`)
- Info view → About information: opens (evidence: `Fungi incognita/Fungi Incognita/SettingsView/InfoView.swift`)
- Info view → Help information: opens (evidence: `Fungi incognita/Fungi Incognita/SettingsView/InfoView.swift`)
- Help information → Help answer cell: renders (evidence: `Fungi incognita/Fungi Incognita/Views/Help.swift`)
