# mugesh-rugby/event-countdown-mobile-app architecture

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

- Interactive diagram: https://gitdiagram.com/mugesh-rugby/event-countdown-mobile-app
- Repository: https://github.com/mugesh-rugby/event-countdown-mobile-app

## Overview

This Flutter app helps users authenticate, create and manage event countdowns, and track upcoming or completed events. Its documented capabilities also include location maps, calendar integration, history, and cloud synchronization. The tree provides filenames but no source excerpts, so the graph shows the product’s documented stages and major feature modules without asserting unverified calls between them. Firebase and feature-to-screen mappings are based on the README and filenames, not inspected implementation.

Main entry points: [`auth_service.dart`](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/auth_service.dart) (Authentication), [`event_service.dart`](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/event_service.dart) (Event Operations), [`main.dart`](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/main.dart) (App Entry), [`home_screen.dart`](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/home_screen.dart) (Home Screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and UI"]
  node_entry["App Entry<br/>[main.dart]"]
  node_app_shell["App Shell<br/>[app.dart]"]
  node_home["Home Screen<br/>[home_screen.dart]"]
  node_colors["App Colors<br/>[app_colors.dart]"]
  node_text_field["Text Field"]
  node_feature_card["Feature Card<br/>[feature_card.dart]"]
  node_gradient_button["Gradient Button"]
end

subgraph group_identity["Authentication"]
  node_login["Login Screen<br/>[login_screen.dart]"]
  node_signup["Signup Screen<br/>[signup_screen.dart]"]
  node_auth_service["Authentication<br/>[auth_service.dart]"]
end

subgraph group_events["Event Management"]
  node_event_model["Event Model<br/>[event_model.dart]"]
  node_event_service["Event Operations<br/>[event_service.dart]"]
  node_event_card["Event Card<br/>[event_card.dart]"]
  node_countdown["Countdown Timer"]
  node_priority["Priority Screen"]
  node_history["Event History"]
  node_location_picker["Location Picker"]
  node_event_map["Event Map"]
end

subgraph group_integrations["Cloud and Integrations"]
  node_calendar["Calendar Screen"]
  node_calendar_sync["Calendar Sync"]
  node_calendar_service["Calendar Service"]
  node_ics_export["Calendar Export<br/>[ics_exporter.dart]"]
  node_notifications["Notifications"]
  node_sharing["Event Sharing<br/>[share_service.dart]"]
  node_remote_config["Remote Config"]
  node_firebase_auth["Firebase Auth"]
  node_firebase_db[("Firebase Database")]
end

node_user(("User"))

node_user -->|"opens app"| node_entry
node_user -.->|"authenticates"| node_login
node_user -.->|"registers"| node_signup
node_auth_service -.->|"uses"| node_firebase_auth
node_event_service -.->|"stores events"| node_firebase_db
node_user -.->|"manages events"| node_home
node_user -.->|"adds location"| node_location_picker
node_user -.->|"schedules events"| node_calendar
node_user -.->|"reviews events"| node_history

click node_entry "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/main.dart"
click node_app_shell "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/app.dart"
click node_home "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/home_screen.dart"
click node_login "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/login_screen.dart"
click node_signup "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/signup_screen.dart"
click node_auth_service "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/auth_service.dart"
click node_event_model "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/event_model.dart"
click node_event_service "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/event_service.dart"
click node_event_card "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/event_card.dart"
click node_countdown "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/countdown_widget.dart"
click node_priority "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/priority_screen.dart"
click node_history "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/history_screen.dart"
click node_location_picker "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/location_picker_screen.dart"
click node_event_map "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/event_map_screen.dart"
click node_calendar "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/calendar_screen.dart"
click node_calendar_sync "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/calendar_sync_screen.dart"
click node_calendar_service "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/calendar_service.dart"
click node_ics_export "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/ics_exporter.dart"
click node_notifications "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/notification_service.dart"
click node_sharing "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/share_service.dart"
click node_remote_config "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/remote_config_service.dart"
click node_colors "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/app_colors.dart"
click node_text_field "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/custom_text_field.dart"
click node_feature_card "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/feature_card.dart"
click node_gradient_button "https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/gradient_button.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_entry,node_app_shell,node_home,node_colors,node_text_field,node_feature_card,node_gradient_button,node_user toneBlue
class node_login,node_signup,node_auth_service toneAmber
class node_event_model,node_event_service,node_event_card,node_countdown,node_priority,node_history,node_location_picker,node_event_map toneMint
class node_calendar,node_calendar_sync,node_calendar_service,node_ics_export,node_notifications,node_sharing,node_remote_config,node_firebase_auth,node_firebase_db toneRose
```

## Components

### App and UI

- [App Entry](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/main.dart): `main.dart`
- [App Shell](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/app.dart): `app.dart`
- [Home Screen](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/home_screen.dart): `home_screen.dart`
- [App Colors](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/app_colors.dart): `app_colors.dart`
- [Text Field](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/custom_text_field.dart): `custom_text_field.dart`
- [Feature Card](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/feature_card.dart): `feature_card.dart`
- [Gradient Button](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/gradient_button.dart): `gradient_button.dart`

### Authentication

- [Login Screen](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/login_screen.dart): `login_screen.dart`
- [Signup Screen](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/signup_screen.dart): `signup_screen.dart`
- [Authentication](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/auth_service.dart): `auth_service.dart`

### Event Management

- [Event Model](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/event_model.dart): `event_model.dart`
- [Event Operations](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/event_service.dart): `event_service.dart`
- [Event Card](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/event_card.dart): `event_card.dart`
- [Countdown Timer](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/countdown_widget.dart): `countdown_widget.dart`
- [Priority Screen](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/priority_screen.dart): `priority_screen.dart`
- [Event History](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/history_screen.dart): `history_screen.dart`
- [Location Picker](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/location_picker_screen.dart): `location_picker_screen.dart`
- [Event Map](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/event_map_screen.dart): `event_map_screen.dart`

### Cloud and Integrations

- [Calendar Screen](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/calendar_screen.dart): `calendar_screen.dart`
- [Calendar Sync](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/calendar_sync_screen.dart): `calendar_sync_screen.dart`
- [Calendar Service](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/calendar_service.dart): `calendar_service.dart`
- [Calendar Export](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/ics_exporter.dart): `ics_exporter.dart`
- [Notifications](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/notification_service.dart): `notification_service.dart`
- [Event Sharing](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/share_service.dart): `share_service.dart`
- [Remote Config](https://github.com/mugesh-rugby/event-countdown-mobile-app/blob/main/remote_config_service.dart): `remote_config_service.dart`
- **Firebase Auth**
- **Firebase Database**

### Other components

- **User**

## Connections

- User → App Entry: opens app (evidence: `README.md`)
- User → Login Screen: authenticates
- User → Signup Screen: registers
- Authentication → Firebase Auth: uses
- Event Operations → Firebase Database: stores events
- User → Home Screen: manages events
- User → Location Picker: adds location
- User → Calendar Screen: schedules events
- User → Event History: reviews events
