# spg-9900/mini_event_album architecture

> Architecture diagram of the GitHub repository spg-9900/mini_event_album, 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/spg-9900/mini_event_album
- Repository: https://github.com/spg-9900/mini_event_album

## Overview

Mini Event Album is a Flutter event-photo application. Its documented user journey is simulated Google sign-in, browsing event albums, opening a photo grid, and viewing or liking a photo. Riverpod providers and an event repository form the principal internal state/data layer; the README describes the event data as coming from a static JSON mock API. Dart implementation details were not excerpted, so UI-to-provider wiring is shown only where documented, and no unverified calls are asserted.

Main entry points: [`lib/Screens/main_navigation_screen.dart`](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/main_navigation_screen.dart) (Main navigation), [`lib/Screens/event_screen.dart`](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/event_screen.dart) (Event list), [`lib/features/events/repositories/event_repository.dart`](https://github.com/spg-9900/mini_event_album/blob/main/lib/features/events/repositories/event_repository.dart) (Event repository), [`lib/Screens/album_screen.dart`](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/album_screen.dart) (Album grid)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["App entry<br/>[main.dart]"]
  node_auth["Sign-in<br/>[auth_screen.dart]"]
  node_loading["Loading screen"]
  node_navigation["Main navigation"]
  node_bottomnav["Bottom navigation"]
  node_profile["Profile screen"]
end

subgraph group_events["Event data"]
  node_eventlist["Event list<br/>[event_screen.dart]"]
  node_eventprovider["Events state"]
  node_repository["Event repository"]
  node_eventmodel["Event model<br/>[event.dart]"]
  node_mockdata["Mock event data<br/>[mock_data.json]"]
  node_album["Album grid<br/>[album_screen.dart]"]
end

subgraph group_engagement["Photo engagement"]
  node_photo["Photo viewer<br/>[photo_screen.dart]"]
  node_likes["Like state"]
end

subgraph group_state["Shared state"]
  node_navprovider["Navigation state"]
end

node_user(("User"))

node_user -->|"signs in"| node_auth
node_auth -.->|"shows loading"| node_loading
node_user -->|"browses events"| node_eventlist
node_eventlist -->|"opens album"| node_album
node_album -->|"opens photo"| node_photo
node_user -->|"likes photo"| node_photo
node_app -.->|"starts at"| node_auth
node_navigation -.->|"shows"| node_eventlist
node_navigation -.->|"uses"| node_bottomnav
node_navigation -.->|"shows"| node_profile
node_navigation -.->|"uses state"| node_navprovider
node_eventlist -.->|"reads events"| node_eventprovider
node_eventprovider -.->|"delegates"| node_repository
node_repository -->|"loads data"| node_mockdata
node_repository -.->|"provides events"| node_eventmodel
node_album -.->|"reads album data"| node_eventprovider
node_photo -.->|"updates likes"| node_likes

click node_app "https://github.com/spg-9900/mini_event_album/blob/main/lib/main.dart"
click node_auth "https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/auth_screen.dart"
click node_loading "https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/loading_screen.dart"
click node_navigation "https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/main_navigation_screen.dart"
click node_navprovider "https://github.com/spg-9900/mini_event_album/blob/main/lib/shared/providers/navigation_provider.dart"
click node_bottomnav "https://github.com/spg-9900/mini_event_album/blob/main/lib/shared/widgets/primary_bottom_nav.dart"
click node_eventlist "https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/event_screen.dart"
click node_eventprovider "https://github.com/spg-9900/mini_event_album/blob/main/lib/features/events/providers/events_providers.dart"
click node_repository "https://github.com/spg-9900/mini_event_album/blob/main/lib/features/events/repositories/event_repository.dart"
click node_eventmodel "https://github.com/spg-9900/mini_event_album/blob/main/lib/features/events/models/event.dart"
click node_mockdata "https://github.com/spg-9900/mini_event_album/blob/main/assets/data/mock_data.json"
click node_album "https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/album_screen.dart"
click node_photo "https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/photo_screen.dart"
click node_likes "https://github.com/spg-9900/mini_event_album/blob/main/lib/features/likes/providers/likes_provider.dart"
click node_profile "https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/profile_screen.dart"

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_auth,node_loading,node_navigation,node_bottomnav,node_profile,node_user toneBlue
class node_eventlist,node_eventprovider,node_repository,node_eventmodel,node_mockdata,node_album toneAmber
class node_photo,node_likes toneMint
class node_navprovider toneRose
```

## Components

### App experience

- [App entry](https://github.com/spg-9900/mini_event_album/blob/main/lib/main.dart): `lib/main.dart`
- [Sign-in](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/auth_screen.dart): `lib/Screens/auth_screen.dart`
- [Loading screen](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/loading_screen.dart): `lib/Screens/loading_screen.dart`
- [Main navigation](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/main_navigation_screen.dart): `lib/Screens/main_navigation_screen.dart`
- [Bottom navigation](https://github.com/spg-9900/mini_event_album/blob/main/lib/shared/widgets/primary_bottom_nav.dart): `lib/shared/widgets/primary_bottom_nav.dart`
- [Profile screen](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/profile_screen.dart): `lib/Screens/profile_screen.dart`

### Event data

- [Event list](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/event_screen.dart): `lib/Screens/event_screen.dart`
- [Events state](https://github.com/spg-9900/mini_event_album/blob/main/lib/features/events/providers/events_providers.dart): `lib/features/events/providers/events_providers.dart`
- [Event repository](https://github.com/spg-9900/mini_event_album/blob/main/lib/features/events/repositories/event_repository.dart): `lib/features/events/repositories/event_repository.dart`
- [Event model](https://github.com/spg-9900/mini_event_album/blob/main/lib/features/events/models/event.dart): `lib/features/events/models/event.dart`
- [Mock event data](https://github.com/spg-9900/mini_event_album/blob/main/assets/data/mock_data.json): `assets/data/mock_data.json`
- [Album grid](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/album_screen.dart): `lib/Screens/album_screen.dart`

### Photo engagement

- [Photo viewer](https://github.com/spg-9900/mini_event_album/blob/main/lib/Screens/photo_screen.dart): `lib/Screens/photo_screen.dart`
- [Like state](https://github.com/spg-9900/mini_event_album/blob/main/lib/features/likes/providers/likes_provider.dart): `lib/features/likes/providers/likes_provider.dart`

### Shared state

- [Navigation state](https://github.com/spg-9900/mini_event_album/blob/main/lib/shared/providers/navigation_provider.dart): `lib/shared/providers/navigation_provider.dart`

### Other components

- **User**

## Connections

- User → Sign-in: signs in (evidence: `README.md`)
- Sign-in → Loading screen: shows loading
- User → Event list: browses events (evidence: `README.md`)
- Event list → Album grid: opens album (evidence: `README.md`)
- Album grid → Photo viewer: opens photo (evidence: `README.md`)
- User → Photo viewer: likes photo (evidence: `README.md`)
- App entry → Sign-in: starts at
- Main navigation → Event list: shows
- Main navigation → Bottom navigation: uses
- Main navigation → Profile screen: shows
- Main navigation → Navigation state: uses state
- Event list → Events state: reads events
- Events state → Event repository: delegates
- Event repository → Mock event data: loads data (evidence: `README.md`)
- Event repository → Event model: provides events
- Album grid → Events state: reads album data
- Photo viewer → Like state: updates likes
