# khooshiaun/pawsbase architecture

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

- Interactive diagram: https://gitdiagram.com/khooshiaun/pawsbase
- Repository: https://github.com/khooshiaun/pawsbase

## Overview

PawsBase is a Flutter pet-care app for owners to manage pet profiles, health logs, training, and everyday settings. The likely user journey begins at the app entry point, proceeds through authentication and the main navigation, then into pet, health, or training screens. README and the file tree establish these product areas, but the sampled source contains only platform runners, not Dart implementations; navigation and service wiring are therefore represented only where the structure and documented purpose support them.

Main entry points: [`lib/views/main/main_page.dart`](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/main/main_page.dart) (Main navigation), [`lib/views/auth/auth_gate.dart`](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/auth/auth_gate.dart) (Auth gate), [`lib/views/settings/settings_page.dart`](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/settings/settings_page.dart) (Settings), [`lib/main.dart`](https://github.com/khooshiaun/pawsbase/blob/main/lib/main.dart) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_entry["App entry<br/>[main.dart]"]
  node_navigation["Main navigation<br/>[main_page.dart]"]
  node_home["Home<br/>[home_page.dart]"]
end

subgraph group_identity["Account access"]
  node_authgate["Auth gate<br/>[auth_gate.dart]"]
  node_login["Login<br/>[login_page.dart]"]
  node_signup["Sign up<br/>[signup_page.dart]"]
  node_authservice["Auth service<br/>[auth_service.dart]"]
end

subgraph group_care["Pet care"]
  node_petprofile["Pet profiles"]
  node_petdetail["Pet detail"]
  node_health["Health logs"]
end

subgraph group_training["Training"]
  node_trainingcheck["Training checklist"]
  node_traininghistory["Training history"]
  node_trainingservice["Training service"]
end

subgraph group_preferences["Settings"]
  node_settings["Settings<br/>[settings_page.dart]"]
  node_profile["Profile settings<br/>[profile_page.dart]"]
  node_help["Help and privacy"]
end

node_owner(("Pet owner"))

node_owner -->|"opens"| node_entry
node_entry -->|"starts"| node_authgate
node_authgate -->|"presents"| node_login
node_authgate -->|"presents"| node_signup
node_login -->|"uses"| node_authservice
node_signup -->|"uses"| node_authservice
node_owner -->|"navigates"| node_navigation
node_navigation -->|"opens"| node_home
node_navigation -->|"opens"| node_petprofile
node_navigation -->|"opens"| node_health
node_navigation -->|"opens"| node_trainingcheck
node_navigation -->|"opens"| node_settings
node_petprofile -->|"views"| node_petdetail
node_trainingcheck -->|"uses"| node_trainingservice
node_traininghistory -->|"uses"| node_trainingservice
node_settings -->|"opens"| node_profile
node_settings -->|"opens"| node_help

click node_entry "https://github.com/khooshiaun/pawsbase/blob/main/lib/main.dart"
click node_navigation "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/main/main_page.dart"
click node_home "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/home/home_page.dart"
click node_authgate "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/auth/auth_gate.dart"
click node_login "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/auth/login_page.dart"
click node_signup "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/auth/signup_page.dart"
click node_authservice "https://github.com/khooshiaun/pawsbase/blob/main/lib/services/auth_service.dart"
click node_petprofile "https://github.com/khooshiaun/pawsbase/tree/main/lib/views/pets"
click node_petdetail "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/pets/pet_detail_page.dart"
click node_health "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/health_log/health_log_page.dart"
click node_trainingcheck "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/training/training_checklist_page.dart"
click node_traininghistory "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/training/training_log_history_page.dart"
click node_trainingservice "https://github.com/khooshiaun/pawsbase/blob/main/lib/services/training_service.dart"
click node_settings "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/settings/settings_page.dart"
click node_profile "https://github.com/khooshiaun/pawsbase/blob/main/lib/views/settings/profile_page.dart"
click node_help "https://github.com/khooshiaun/pawsbase/tree/main/lib/views/settings"

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_navigation,node_home toneBlue
class node_authgate,node_login,node_signup,node_authservice toneAmber
class node_petprofile,node_petdetail,node_health toneMint
class node_trainingcheck,node_traininghistory,node_trainingservice toneRose
class node_settings,node_profile,node_help,node_owner toneIndigo
```

## Components

### App navigation

- [App entry](https://github.com/khooshiaun/pawsbase/blob/main/lib/main.dart): `lib/main.dart`
- [Main navigation](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/main/main_page.dart): `lib/views/main/main_page.dart`
- [Home](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/home/home_page.dart): `lib/views/home/home_page.dart`

### Account access

- [Auth gate](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/auth/auth_gate.dart): `lib/views/auth/auth_gate.dart`
- [Login](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/auth/login_page.dart): `lib/views/auth/login_page.dart`
- [Sign up](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/auth/signup_page.dart): `lib/views/auth/signup_page.dart`
- [Auth service](https://github.com/khooshiaun/pawsbase/blob/main/lib/services/auth_service.dart): `lib/services/auth_service.dart`

### Pet care

- [Pet profiles](https://github.com/khooshiaun/pawsbase/tree/main/lib/views/pets): `lib/views/pets`
- [Pet detail](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/pets/pet_detail_page.dart): `lib/views/pets/pet_detail_page.dart`
- [Health logs](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/health_log/health_log_page.dart): `lib/views/health_log/health_log_page.dart`

### Training

- [Training checklist](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/training/training_checklist_page.dart): `lib/views/training/training_checklist_page.dart`
- [Training history](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/training/training_log_history_page.dart): `lib/views/training/training_log_history_page.dart`
- [Training service](https://github.com/khooshiaun/pawsbase/blob/main/lib/services/training_service.dart): `lib/services/training_service.dart`

### Settings

- [Settings](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/settings/settings_page.dart): `lib/views/settings/settings_page.dart`
- [Profile settings](https://github.com/khooshiaun/pawsbase/blob/main/lib/views/settings/profile_page.dart): `lib/views/settings/profile_page.dart`
- [Help and privacy](https://github.com/khooshiaun/pawsbase/tree/main/lib/views/settings): `lib/views/settings`

### Other components

- **Pet owner**

## Connections

- Pet owner → App entry: opens
- App entry → Auth gate: starts
- Auth gate → Login: presents
- Auth gate → Sign up: presents
- Login → Auth service: uses
- Sign up → Auth service: uses
- Pet owner → Main navigation: navigates
- Main navigation → Home: opens
- Main navigation → Pet profiles: opens
- Main navigation → Health logs: opens
- Main navigation → Training checklist: opens
- Main navigation → Settings: opens
- Pet profiles → Pet detail: views
- Training checklist → Training service: uses
- Training history → Training service: uses
- Settings → Profile settings: opens
- Settings → Help and privacy: opens