# lotivioaaron1/homegrown architecture

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

- Interactive diagram: https://gitdiagram.com/lotivioaaron1/homegrown
- Repository: https://github.com/lotivioaaron1/homegrown

## Overview

Homegrown is a Flutter community athletics app for athletes, coaches, and organizers in Legazpi City. Its principal workflow is role-based sign-in and onboarding, followed by participation in or creation of athletics events, recording performance, and viewing standings and dashboards. Venue discovery and map-based location tools are a separate capability. The README documents Firebase as the backend and names the Maps service integrations; detailed Dart call paths were not sampled, so edges reflect only those documented relationships.

Main entry points: [`lib/screens/auth`](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/auth) (Sign-in and registration), [`lib/screens/onboarding`](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/onboarding) (Onboarding), [`lib/screens/events`](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/events) (Events), [`lib/screens/stats`](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/stats) (Stats tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_auth["Sign-in and registration"]
  node_onboarding["Onboarding"]
  node_profiles["Profiles"]
  node_home["Home"]
end

subgraph group_sports["Athletics workflows"]
  node_events["Events"]
  node_teams["Teams"]
  node_tournaments["Tournaments"]
  node_stats["Stats tracking"]
end

subgraph group_insights["Discovery and insights"]
  node_leaderboard["Leaderboards"]
  node_dashboard["Performance dashboards"]
  node_scouting["Scouting"]
  node_venues["Venue locator"]
end

subgraph group_platform["Services and data"]
  node_maps["Places, geocoding, directions"]
  node_firebase_auth["Firebase Authentication"]
  node_firebase_data[("Firebase data and storage")]
  node_services["App services"]
end

node_user(("Athletes, coaches, organizers"))

node_user -->|"signs in"| node_auth
node_user -->|"onboards"| node_onboarding
node_auth -->|"authenticates"| node_firebase_auth
node_onboarding -.->|"sets up role"| node_profiles
node_user -->|"creates or joins"| node_events
node_user -.->|"manages teams"| node_teams
node_user -.->|"manages tournaments"| node_tournaments
node_user -->|"tracks performance"| node_stats
node_user -->|"views standings"| node_leaderboard
node_user -->|"views performance"| node_dashboard
node_user -.->|"scouts athletes"| node_scouting
node_user -->|"finds venues"| node_venues
node_events -->|"uses Firebase"| node_firebase_data
node_stats -->|"uses Firebase"| node_firebase_data
node_services -->|"Firebase backend"| node_firebase_data
node_venues -->|"uses map services"| node_maps
node_maps -.->|"returns location results"| node_user

click node_auth "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/auth"
click node_onboarding "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/onboarding"
click node_profiles "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/profile"
click node_home "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/home"
click node_events "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/events"
click node_teams "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/team"
click node_tournaments "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/tournaments"
click node_stats "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/stats"
click node_leaderboard "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/leaderboard"
click node_dashboard "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/dashboard"
click node_scouting "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/scout"
click node_venues "https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/venues"
click node_maps "https://github.com/lotivioaaron1/homegrown/tree/main/lib/services"
click node_services "https://github.com/lotivioaaron1/homegrown/tree/main/lib/services"

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_onboarding,node_profiles,node_home toneBlue
class node_events,node_teams,node_tournaments,node_stats toneAmber
class node_leaderboard,node_dashboard,node_scouting,node_venues toneMint
class node_maps,node_firebase_auth,node_firebase_data,node_services toneRose
class node_user toneIndigo
```

## Components

### App experience

- [Sign-in and registration](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/auth): `lib/screens/auth`
- [Onboarding](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/onboarding): `lib/screens/onboarding`
- [Profiles](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/profile): `lib/screens/profile`
- [Home](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/home): `lib/screens/home`

### Athletics workflows

- [Events](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/events): `lib/screens/events`
- [Teams](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/team): `lib/screens/team`
- [Tournaments](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/tournaments): `lib/screens/tournaments`
- [Stats tracking](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/stats): `lib/screens/stats`

### Discovery and insights

- [Leaderboards](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/leaderboard): `lib/screens/leaderboard`
- [Performance dashboards](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/dashboard): `lib/screens/dashboard`
- [Scouting](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/scout): `lib/screens/scout`
- [Venue locator](https://github.com/lotivioaaron1/homegrown/tree/main/lib/screens/venues): `lib/screens/venues`

### Services and data

- [Places, geocoding, directions](https://github.com/lotivioaaron1/homegrown/tree/main/lib/services): `lib/services`
- **Firebase Authentication**
- **Firebase data and storage**
- [App services](https://github.com/lotivioaaron1/homegrown/tree/main/lib/services): `lib/services`

### Other components

- **Athletes, coaches, organizers**

## Connections

- Athletes, coaches, organizers → Sign-in and registration: signs in (evidence: `README.md`)
- Athletes, coaches, organizers → Onboarding: onboards (evidence: `README.md`)
- Sign-in and registration → Firebase Authentication: authenticates (evidence: `README.md`)
- Onboarding → Profiles: sets up role
- Athletes, coaches, organizers → Events: creates or joins (evidence: `README.md`)
- Athletes, coaches, organizers → Teams: manages teams
- Athletes, coaches, organizers → Tournaments: manages tournaments
- Athletes, coaches, organizers → Stats tracking: tracks performance (evidence: `README.md`)
- Athletes, coaches, organizers → Leaderboards: views standings (evidence: `README.md`)
- Athletes, coaches, organizers → Performance dashboards: views performance (evidence: `README.md`)
- Athletes, coaches, organizers → Scouting: scouts athletes
- Athletes, coaches, organizers → Venue locator: finds venues (evidence: `README.md`)
- Events → Firebase data and storage: uses Firebase (evidence: `README.md`)
- Stats tracking → Firebase data and storage: uses Firebase (evidence: `README.md`)
- App services → Firebase data and storage: Firebase backend (evidence: `README.md`)
- Venue locator → Places, geocoding, directions: uses map services (evidence: `README.md`)
- Places, geocoding, directions → Athletes, coaches, organizers: returns location results
