# joa111/nurseapp architecture

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

- Interactive diagram: https://gitdiagram.com/joa111/nurseapp
- Repository: https://github.com/joa111/nurseapp

## Overview

NurseApp is a React frontend for nurses to register, manage a care profile, and handle incoming service requests and bookings. The main user journey runs through the app’s routed pages: registration creates an account and nurse record; authenticated nurses can review requests, update profile details, and manage booking status. Firebase provides authentication and data persistence. The README contains only Create React App setup guidance, so product capabilities and relationships here are grounded in the provided source excerpts and index; unsampled page behavior is not expanded beyond those references.

Main entry points: [`src/App.js`](https://github.com/joa111/nurseapp/blob/main/src/App.js) (Route shell), [`src/services/firebase.js`](https://github.com/joa111/nurseapp/blob/main/src/services/firebase.js) (Firebase client), [`src/components/ui/DesignSystem.js`](https://github.com/joa111/nurseapp/blob/main/src/components/ui/DesignSystem.js) (UI components), [`src/context/AuthContext.js`](https://github.com/joa111/nurseapp/blob/main/src/context/AuthContext.js) (Auth state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_app["Route shell<br/>[App.js]"]
  node_navigation["Navigation<br/>[Navigation.js]"]
  node_auth_context["Auth state<br/>[AuthContext.js]"]
end

subgraph group_nurse["Nurse workflows"]
  node_home["Home<br/>[HomePage.js]"]
  node_login["Login<br/>[LoginPage.js]"]
  node_registration_page["Registration page"]
  node_registration_form["Nurse registration<br/>[MultiStepForm.js]"]
  node_dashboard["Requests and bookings<br/>[DashboardPage.js]"]
  node_profile["Profile management"]
end

subgraph group_firebase["Firebase services"]
  node_firebase_client["Firebase client<br/>[firebase.js]"]
end

subgraph group_presentation["Presentation system"]
  node_design_system["UI components<br/>[DesignSystem.js]"]
  node_icons["Navigation icons<br/>[Icons.js]"]
  node_design_tokens["Design tokens<br/>[designTokens.js]"]
  node_global_styles["Global styles<br/>[GlobalStyles.js]"]
end

node_nurse_actor(("Nurse"))
node_firebase_auth["Firebase Auth"]
node_firestore[("Cloud Firestore")]

node_nurse_actor -->|"uses"| node_app
node_app -->|"renders"| node_navigation
node_app -->|"provides auth"| node_auth_context
node_app -->|"applies"| node_global_styles
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_registration_page
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_profile
node_registration_page -->|"renders"| node_registration_form
node_navigation -->|"reads auth"| node_auth_context
node_navigation -->|"signs out through"| node_firebase_client
node_navigation -->|"uses components"| node_design_system
node_navigation -->|"renders"| node_icons
node_auth_context -->|"observes auth"| node_firebase_client
node_registration_form -->|"uses services"| node_firebase_client
node_registration_form -->|"creates account"| node_firebase_auth
node_registration_form -->|"writes nurse record"| node_firestore
node_login -->|"uses services"| node_firebase_client
node_login -->|"authenticates"| node_firebase_auth
node_home -->|"reads auth"| node_auth_context
node_home -->|"uses services"| node_firebase_client
node_home -->|"reads nurse profile"| node_firestore
node_dashboard -->|"reads auth"| node_auth_context
node_dashboard -->|"uses services"| node_firebase_client
node_dashboard -->|"reads requests and updates"| node_firestore
node_profile -->|"reads auth"| node_auth_context
node_profile -->|"uses services"| node_firebase_client
node_profile -->|"loads and updates profile"| node_firestore
node_firebase_client -->|"initializes"| node_firebase_auth
node_firebase_client -->|"initializes"| node_firestore
node_design_system -->|"uses tokens"| node_design_tokens
node_global_styles -->|"uses tokens"| node_design_tokens
node_home -->|"uses components"| node_design_system
node_dashboard -->|"uses components"| node_design_system
node_profile -->|"uses components"| node_design_system
node_registration_form -->|"uses components"| node_design_system
node_login -->|"uses components"| node_design_system
node_registration_page -->|"uses components"| node_design_system

click node_app "https://github.com/joa111/nurseapp/blob/main/src/App.js"
click node_navigation "https://github.com/joa111/nurseapp/blob/main/src/components/ui/Navigation.js"
click node_auth_context "https://github.com/joa111/nurseapp/blob/main/src/context/AuthContext.js"
click node_home "https://github.com/joa111/nurseapp/blob/main/src/pages/HomePage.js"
click node_login "https://github.com/joa111/nurseapp/blob/main/src/pages/LoginPage.js"
click node_registration_page "https://github.com/joa111/nurseapp/blob/main/src/pages/RegistrationPage.js"
click node_registration_form "https://github.com/joa111/nurseapp/blob/main/src/components/registration/MultiStepForm.js"
click node_dashboard "https://github.com/joa111/nurseapp/blob/main/src/pages/DashboardPage.js"
click node_profile "https://github.com/joa111/nurseapp/blob/main/src/pages/NurseProfileManagementPage.js"
click node_firebase_client "https://github.com/joa111/nurseapp/blob/main/src/services/firebase.js"
click node_design_system "https://github.com/joa111/nurseapp/blob/main/src/components/ui/DesignSystem.js"
click node_icons "https://github.com/joa111/nurseapp/blob/main/src/components/ui/Icons.js"
click node_design_tokens "https://github.com/joa111/nurseapp/blob/main/src/styles/designTokens.js"
click node_global_styles "https://github.com/joa111/nurseapp/blob/main/src/styles/GlobalStyles.js"

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_navigation,node_auth_context toneBlue
class node_home,node_login,node_registration_page,node_registration_form,node_dashboard,node_profile,node_firestore toneAmber
class node_firebase_client toneMint
class node_design_system,node_icons,node_design_tokens,node_global_styles toneRose
class node_nurse_actor,node_firebase_auth toneIndigo
```

## Components

### App and navigation

- [Route shell](https://github.com/joa111/nurseapp/blob/main/src/App.js): `src/App.js`
- [Navigation](https://github.com/joa111/nurseapp/blob/main/src/components/ui/Navigation.js): `src/components/ui/Navigation.js`
- [Auth state](https://github.com/joa111/nurseapp/blob/main/src/context/AuthContext.js): `src/context/AuthContext.js`

### Nurse workflows

- [Home](https://github.com/joa111/nurseapp/blob/main/src/pages/HomePage.js): `src/pages/HomePage.js`
- [Login](https://github.com/joa111/nurseapp/blob/main/src/pages/LoginPage.js): `src/pages/LoginPage.js`
- [Registration page](https://github.com/joa111/nurseapp/blob/main/src/pages/RegistrationPage.js): `src/pages/RegistrationPage.js`
- [Nurse registration](https://github.com/joa111/nurseapp/blob/main/src/components/registration/MultiStepForm.js): `src/components/registration/MultiStepForm.js`
- [Requests and bookings](https://github.com/joa111/nurseapp/blob/main/src/pages/DashboardPage.js): `src/pages/DashboardPage.js`
- [Profile management](https://github.com/joa111/nurseapp/blob/main/src/pages/NurseProfileManagementPage.js): `src/pages/NurseProfileManagementPage.js`

### Firebase services

- [Firebase client](https://github.com/joa111/nurseapp/blob/main/src/services/firebase.js): `src/services/firebase.js`

### Presentation system

- [UI components](https://github.com/joa111/nurseapp/blob/main/src/components/ui/DesignSystem.js): `src/components/ui/DesignSystem.js`
- [Navigation icons](https://github.com/joa111/nurseapp/blob/main/src/components/ui/Icons.js): `src/components/ui/Icons.js`
- [Design tokens](https://github.com/joa111/nurseapp/blob/main/src/styles/designTokens.js): `src/styles/designTokens.js`
- [Global styles](https://github.com/joa111/nurseapp/blob/main/src/styles/GlobalStyles.js): `src/styles/GlobalStyles.js`

### Other components

- **Nurse**
- **Firebase Auth**
- **Cloud Firestore**

## Connections

- Nurse → Route shell: uses (evidence: `src/App.js`)
- Route shell → Navigation: renders (evidence: `src/App.js`)
- Route shell → Auth state: provides auth (evidence: `src/App.js`)
- Route shell → Global styles: applies (evidence: `src/App.js`)
- Route shell → Home: routes to (evidence: `src/App.js`)
- Route shell → Login: routes to (evidence: `src/App.js`)
- Route shell → Registration page: routes to (evidence: `src/App.js`)
- Route shell → Requests and bookings: routes to (evidence: `src/App.js`)
- Route shell → Profile management: routes to (evidence: `src/App.js`)
- Registration page → Nurse registration: renders (evidence: `src/pages/RegistrationPage.js`)
- Navigation → Auth state: reads auth (evidence: `src/components/ui/Navigation.js`)
- Navigation → Firebase client: signs out through (evidence: `src/components/ui/Navigation.js`)
- Navigation → UI components: uses components (evidence: `src/components/ui/Navigation.js`)
- Navigation → Navigation icons: renders (evidence: `src/components/ui/Navigation.js`)
- Auth state → Firebase client: observes auth (evidence: `src/context/AuthContext.js`)
- Nurse registration → Firebase client: uses services (evidence: `src/components/registration/MultiStepForm.js`)
- Nurse registration → Firebase Auth: creates account (evidence: `src/components/registration/MultiStepForm.js`)
- Nurse registration → Cloud Firestore: writes nurse record (evidence: `src/components/registration/MultiStepForm.js`)
- Login → Firebase client: uses services (evidence: `src/pages/LoginPage.js`)
- Login → Firebase Auth: authenticates (evidence: `src/pages/LoginPage.js`)
- Home → Auth state: reads auth (evidence: `src/pages/HomePage.js`)
- Home → Firebase client: uses services (evidence: `src/pages/HomePage.js`)
- Home → Cloud Firestore: reads nurse profile (evidence: `src/pages/HomePage.js`)
- Requests and bookings → Auth state: reads auth (evidence: `src/pages/DashboardPage.js`)
- Requests and bookings → Firebase client: uses services (evidence: `src/pages/DashboardPage.js`)
- Requests and bookings → Cloud Firestore: reads requests and updates (evidence: `src/pages/DashboardPage.js`)
- Profile management → Auth state: reads auth (evidence: `src/pages/NurseProfileManagementPage.js`)
- Profile management → Firebase client: uses services (evidence: `src/pages/NurseProfileManagementPage.js`)
- Profile management → Cloud Firestore: loads and updates profile (evidence: `src/pages/NurseProfileManagementPage.js`)
- Firebase client → Firebase Auth: initializes (evidence: `src/services/firebase.js`)
- Firebase client → Cloud Firestore: initializes (evidence: `src/services/firebase.js`)
- UI components → Design tokens: uses tokens (evidence: `src/components/ui/DesignSystem.js`)
- Global styles → Design tokens: uses tokens (evidence: `src/styles/GlobalStyles.js`)
- Home → UI components: uses components (evidence: `src/pages/HomePage.js`)
- Requests and bookings → UI components: uses components (evidence: `src/pages/DashboardPage.js`)
- Profile management → UI components: uses components (evidence: `src/pages/NurseProfileManagementPage.js`)
- Nurse registration → UI components: uses components (evidence: `src/components/registration/MultiStepForm.js`)
- Login → UI components: uses components (evidence: `src/pages/LoginPage.js`)
- Registration page → UI components: uses components (evidence: `src/pages/RegistrationPage.js`)
