# athangramteke/osteoai architecture

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

- Interactive diagram: https://gitdiagram.com/athangramteke/osteoai
- Repository: https://github.com/athangramteke/osteoai

## Overview

OsteoAI is presented as an osteoporosis-risk assessment experience. The visible user journey is landing page → assessment form stages, with routes also exposing login and dashboard pages. The README and landing content describe ML risk prediction, SHAP explanations, lifestyle guidance, future-risk simulation, and an AI assistant; the sampled runtime shows no implementation of those services, so they are represented as product claims rather than working backend stages.

Main entry points: [`src/pages/Assessment/Assessment.jsx`](https://github.com/athangramteke/osteoai/blob/main/src/pages/Assessment/Assessment.jsx) (Assessment page), [`src/features/landing/LandingPage.jsx`](https://github.com/athangramteke/osteoai/blob/main/src/features/landing/LandingPage.jsx) (Landing page), [`src/routes/AppRoutes.jsx`](https://github.com/athangramteke/osteoai/blob/main/src/routes/AppRoutes.jsx) (Page routes), [`src/components/landing/HowItWorks.jsx`](https://github.com/athangramteke/osteoai/blob/main/src/components/landing/HowItWorks.jsx) (Process overview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application shell"]
  node_bootstrap["React bootstrap<br/>[main.jsx]"]
  node_app["App shell<br/>[App.jsx]"]
  node_routes["Page routes<br/>[AppRoutes.jsx]"]
  node_login["Login page<br/>[LoginPage.jsx]"]
  node_dashboard["Dashboard page<br/>[DashboardPage.jsx]"]
end

subgraph group_landing["Landing experience"]
  node_landing["Landing page<br/>[LandingPage.jsx]"]
  node_navbar["Navigation bar<br/>[Navbar.jsx]"]
  node_hero["Hero section<br/>[Hero.jsx]"]
  node_features["Feature overview"]
  node_howworks["Process overview<br/>[HowItWorks.jsx]"]
  node_stepcard["Process step card<br/>[StepCard.jsx]"]
end

subgraph group_assessment["Assessment workflow"]
  node_assessment["Assessment page<br/>[Assessment.jsx]"]
  node_stepper["Assessment stepper"]
  node_personal["Personal details"]
  node_lifestyle["Lifestyle details<br/>[LifestyleForm.jsx]"]
  node_medical["Medical history"]
  node_navigation["Step controls"]
end

subgraph group_capabilities["Described capabilities"]
  node_prediction["ML risk prediction<br/>[HowItWorks.jsx]"]
  node_explanation["SHAP explanation<br/>[HowItWorks.jsx]"]
  node_guidance["Health guidance<br/>[HowItWorks.jsx]"]
  node_assistant["AI health assistant<br/>[README.md]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_landing
node_bootstrap -->|"renders"| node_app
node_app -->|"renders"| node_routes
node_routes -->|"routes to"| node_landing
node_routes -->|"routes to"| node_assessment
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_dashboard
node_landing -->|"renders"| node_navbar
node_landing -->|"renders"| node_hero
node_landing -->|"renders"| node_features
node_landing -->|"renders"| node_howworks
node_hero -->|"navigates to"| node_assessment
node_howworks -->|"renders"| node_stepcard
node_assessment -->|"renders"| node_stepper
node_assessment -->|"renders"| node_personal
node_assessment -->|"renders"| node_lifestyle
node_assessment -->|"renders"| node_medical
node_assessment -->|"renders"| node_navigation
node_howworks -->|"describes"| node_prediction
node_howworks -->|"describes"| node_explanation
node_howworks -->|"describes"| node_guidance
node_visitor -.->|"product claim"| node_assistant

click node_bootstrap "https://github.com/athangramteke/osteoai/blob/main/src/main.jsx"
click node_app "https://github.com/athangramteke/osteoai/blob/main/src/App.jsx"
click node_routes "https://github.com/athangramteke/osteoai/blob/main/src/routes/AppRoutes.jsx"
click node_landing "https://github.com/athangramteke/osteoai/blob/main/src/features/landing/LandingPage.jsx"
click node_navbar "https://github.com/athangramteke/osteoai/blob/main/src/components/common/Navbar.jsx"
click node_hero "https://github.com/athangramteke/osteoai/blob/main/src/components/landing/Hero.jsx"
click node_features "https://github.com/athangramteke/osteoai/blob/main/src/components/landing/FeaturesSection.jsx"
click node_howworks "https://github.com/athangramteke/osteoai/blob/main/src/components/landing/HowItWorks.jsx"
click node_stepcard "https://github.com/athangramteke/osteoai/blob/main/src/components/landing/StepCard.jsx"
click node_assessment "https://github.com/athangramteke/osteoai/blob/main/src/pages/Assessment/Assessment.jsx"
click node_stepper "https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/AssessmentStepper.jsx"
click node_personal "https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/PersonalInfoForm.jsx"
click node_lifestyle "https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/LifestyleForm.jsx"
click node_medical "https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/MedicalHistoryForm.jsx"
click node_navigation "https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/NavigationButtons.jsx"
click node_prediction "https://github.com/athangramteke/osteoai/blob/main/src/components/landing/HowItWorks.jsx"
click node_explanation "https://github.com/athangramteke/osteoai/blob/main/src/components/landing/HowItWorks.jsx"
click node_guidance "https://github.com/athangramteke/osteoai/blob/main/src/components/landing/HowItWorks.jsx"
click node_assistant "https://github.com/athangramteke/osteoai/blob/main/README.md"
click node_login "https://github.com/athangramteke/osteoai/blob/main/src/features/authentication/LoginPage.jsx"
click node_dashboard "https://github.com/athangramteke/osteoai/blob/main/src/features/dashboard/DashboardPage.jsx"

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_bootstrap,node_app,node_routes,node_login,node_dashboard toneBlue
class node_landing,node_navbar,node_hero,node_features,node_howworks,node_stepcard toneAmber
class node_assessment,node_stepper,node_personal,node_lifestyle,node_medical,node_navigation toneMint
class node_prediction,node_explanation,node_guidance,node_assistant toneRose
class node_visitor toneIndigo
```

## Components

### Application shell

- [React bootstrap](https://github.com/athangramteke/osteoai/blob/main/src/main.jsx): `src/main.jsx`
- [App shell](https://github.com/athangramteke/osteoai/blob/main/src/App.jsx): `src/App.jsx`
- [Page routes](https://github.com/athangramteke/osteoai/blob/main/src/routes/AppRoutes.jsx): `src/routes/AppRoutes.jsx`
- [Login page](https://github.com/athangramteke/osteoai/blob/main/src/features/authentication/LoginPage.jsx): `src/features/authentication/LoginPage.jsx`
- [Dashboard page](https://github.com/athangramteke/osteoai/blob/main/src/features/dashboard/DashboardPage.jsx): `src/features/dashboard/DashboardPage.jsx`

### Landing experience

- [Landing page](https://github.com/athangramteke/osteoai/blob/main/src/features/landing/LandingPage.jsx): `src/features/landing/LandingPage.jsx`
- [Navigation bar](https://github.com/athangramteke/osteoai/blob/main/src/components/common/Navbar.jsx): `src/components/common/Navbar.jsx`
- [Hero section](https://github.com/athangramteke/osteoai/blob/main/src/components/landing/Hero.jsx): `src/components/landing/Hero.jsx`
- [Feature overview](https://github.com/athangramteke/osteoai/blob/main/src/components/landing/FeaturesSection.jsx): `src/components/landing/FeaturesSection.jsx`
- [Process overview](https://github.com/athangramteke/osteoai/blob/main/src/components/landing/HowItWorks.jsx): `src/components/landing/HowItWorks.jsx`
- [Process step card](https://github.com/athangramteke/osteoai/blob/main/src/components/landing/StepCard.jsx): `src/components/landing/StepCard.jsx`

### Assessment workflow

- [Assessment page](https://github.com/athangramteke/osteoai/blob/main/src/pages/Assessment/Assessment.jsx): `src/pages/Assessment/Assessment.jsx`
- [Assessment stepper](https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/AssessmentStepper.jsx): `src/components/assessment/AssessmentStepper.jsx`
- [Personal details](https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/PersonalInfoForm.jsx): `src/components/assessment/PersonalInfoForm.jsx`
- [Lifestyle details](https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/LifestyleForm.jsx): `src/components/assessment/LifestyleForm.jsx`
- [Medical history](https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/MedicalHistoryForm.jsx): `src/components/assessment/MedicalHistoryForm.jsx`
- [Step controls](https://github.com/athangramteke/osteoai/blob/main/src/components/assessment/NavigationButtons.jsx): `src/components/assessment/NavigationButtons.jsx`

### Described capabilities

- [ML risk prediction](https://github.com/athangramteke/osteoai/blob/main/src/components/landing/HowItWorks.jsx): `src/components/landing/HowItWorks.jsx`
- [SHAP explanation](https://github.com/athangramteke/osteoai/blob/main/src/components/landing/HowItWorks.jsx): `src/components/landing/HowItWorks.jsx`
- [Health guidance](https://github.com/athangramteke/osteoai/blob/main/src/components/landing/HowItWorks.jsx): `src/components/landing/HowItWorks.jsx`
- [AI health assistant](https://github.com/athangramteke/osteoai/blob/main/README.md): `README.md`

### Other components

- **Visitor**

## Connections

- Visitor → Landing page: opens
- React bootstrap → App shell: renders (evidence: `src/main.jsx`)
- App shell → Page routes: renders (evidence: `src/App.jsx`)
- Page routes → Landing page: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Page routes → Assessment page: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Page routes → Login page: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Page routes → Dashboard page: routes to (evidence: `src/routes/AppRoutes.jsx`)
- Landing page → Navigation bar: renders (evidence: `src/features/landing/LandingPage.jsx`)
- Landing page → Hero section: renders (evidence: `src/features/landing/LandingPage.jsx`)
- Landing page → Feature overview: renders (evidence: `src/features/landing/LandingPage.jsx`)
- Landing page → Process overview: renders (evidence: `src/features/landing/LandingPage.jsx`)
- Hero section → Assessment page: navigates to (evidence: `src/components/landing/Hero.jsx`)
- Process overview → Process step card: renders (evidence: `src/components/landing/HowItWorks.jsx`)
- Assessment page → Assessment stepper: renders (evidence: `src/pages/Assessment/Assessment.jsx`)
- Assessment page → Personal details: renders (evidence: `src/pages/Assessment/Assessment.jsx`)
- Assessment page → Lifestyle details: renders (evidence: `src/pages/Assessment/Assessment.jsx`)
- Assessment page → Medical history: renders (evidence: `src/pages/Assessment/Assessment.jsx`)
- Assessment page → Step controls: renders (evidence: `src/pages/Assessment/Assessment.jsx`)
- Process overview → ML risk prediction: describes (evidence: `src/components/landing/HowItWorks.jsx`)
- Process overview → SHAP explanation: describes (evidence: `src/components/landing/HowItWorks.jsx`)
- Process overview → Health guidance: describes (evidence: `src/components/landing/HowItWorks.jsx`)
- Visitor → AI health assistant: product claim (evidence: `README.md`)
