# zencron/cohab architecture

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

- Interactive diagram: https://gitdiagram.com/zencron/cohab
- Repository: https://github.com/zencron/cohab

## Overview

CoHab is a roommate-oriented mobile app for shared tasks, chores, calendar events, group management, and household finances, backed by a Tomcat servlet application. The user-facing flow enters through app navigation, then into feature screens and their task or finance components. The tree also documents calendar, chore, group, profile, and account endpoints. Several screens and backend handlers were not sampled, so those capabilities are represented without inferred links between mobile and server components.

Main entry points: [`screens/Finance/FinanceScreen.js`](https://github.com/zencron/cohab/blob/main/screens/Finance/FinanceScreen.js) (Finance screen), [`App.js`](https://github.com/zencron/cohab/blob/main/App.js) (App entry), [`screens/TaskScreen.js`](https://github.com/zencron/cohab/blob/main/screens/TaskScreen.js) (Task screen), [`components/task/MyTasks.js`](https://github.com/zencron/cohab/blob/main/components/task/MyTasks.js) (My tasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Mobile app shell"]
  node_app["App entry<br/>[App.js]"]
  node_loginctx["Login context<br/>[LoginContext.js]"]
  node_navigation["Root navigation<br/>[RootStackScreen.js]"]
  node_home["Home screen<br/>[HomeScreen.js]"]
  node_taskscreen["Task screen<br/>[TaskScreen.js]"]
  node_authscreens["Login and register<br/>[LoginScreen.js]"]
  node_basictext["Text component<br/>[BasicText.js]"]
  node_constants["Shared constants<br/>[ConstantHelper.js]"]
end

subgraph group_tasks["Tasks and chores"]
  node_mytasks["My tasks<br/>[MyTasks.js]"]
  node_tasktabs["Task tabs<br/>[SharedTasks.js]"]
  node_taskcard["Task card<br/>[TaskCard.js]"]
  node_taskmodal["Task editor<br/>[TaskModal.js]"]
  node_claimmodal["Claim task"]
  node_chorescreen["Chore screen<br/>[ChoreScreen.js]"]
  node_chorecard["Chore card<br/>[ChoreCard.js]"]
  node_choremodal["Chore editor<br/>[ChoreModal.js]"]
  node_choreedit["Edit chore<br/>[ChoreModalEDIT.js]"]
end

subgraph group_household["Household features"]
  node_calendar["Calendar screen<br/>[CalendarScreen.js]"]
  node_eventmodal["Event editor<br/>[CalendarModal.js]"]
  node_finance["Finance screen<br/>[FinanceScreen.js]"]
  node_budget["Budget graph<br/>[BudgetGraph.js]"]
  node_grouppay["Group payments<br/>[GroupPayCard.js]"]
  node_roommates["Roommate payments<br/>[RoommateCard.js]"]
  node_groupselect["Group selection"]
  node_addgroup["Create group<br/>[AddGroupModal.js]"]
  node_joingroup["Join group<br/>[JoinGroupModal.js]"]
end

subgraph group_server["Tomcat backend"]
  node_authservlets["Account endpoints<br/>[LoginServlet.java]"]
  node_taskservlets["Task endpoints"]
  node_choreservlets["Chore endpoints"]
  node_eventservlets["Event endpoints"]
  node_financeapi["Bill endpoints"]
  node_groupapi["Group endpoints"]
  node_profileapi["Profile endpoints"]
end

node_user(("Resident"))

node_user -->|"opens"| node_app
node_app -->|"renders"| node_navigation
node_app -->|"provides context"| node_loginctx
node_user -->|"views tasks"| node_taskscreen
node_taskscreen -->|"renders"| node_mytasks
node_taskscreen -->|"renders"| node_tasktabs
node_mytasks -->|"renders"| node_taskcard
node_mytasks -->|"opens"| node_taskmodal
node_taskcard -->|"opens"| node_claimmodal
node_user -->|"views home"| node_home
node_user -->|"views finances"| node_finance
node_finance -->|"renders"| node_budget
node_finance -->|"renders"| node_grouppay
node_finance -->|"renders"| node_roommates
node_eventmodal -->|"renders"| node_basictext
node_choreedit -->|"uses"| node_constants

click node_app "https://github.com/zencron/cohab/blob/main/App.js"
click node_loginctx "https://github.com/zencron/cohab/blob/main/LoginContext.js"
click node_navigation "https://github.com/zencron/cohab/blob/main/navigation/RootStackScreen.js"
click node_home "https://github.com/zencron/cohab/blob/main/screens/HomeScreen.js"
click node_taskscreen "https://github.com/zencron/cohab/blob/main/screens/TaskScreen.js"
click node_mytasks "https://github.com/zencron/cohab/blob/main/components/task/MyTasks.js"
click node_tasktabs "https://github.com/zencron/cohab/blob/main/components/task/SharedTasks.js"
click node_taskcard "https://github.com/zencron/cohab/blob/main/components/task/TaskCard.js"
click node_taskmodal "https://github.com/zencron/cohab/blob/main/components/task/TaskModal.js"
click node_claimmodal "https://github.com/zencron/cohab/blob/main/components/task/ClaimTaskSDModal.js"
click node_chorescreen "https://github.com/zencron/cohab/blob/main/screens/ChoreScreen.js"
click node_chorecard "https://github.com/zencron/cohab/blob/main/components/chore/ChoreCard.js"
click node_choremodal "https://github.com/zencron/cohab/blob/main/components/chore/ChoreModal.js"
click node_choreedit "https://github.com/zencron/cohab/blob/main/components/chore/ChoreModalEDIT.js"
click node_calendar "https://github.com/zencron/cohab/blob/main/screens/CalendarScreen.js"
click node_eventmodal "https://github.com/zencron/cohab/blob/main/components/calendar/CalendarModal.js"
click node_finance "https://github.com/zencron/cohab/blob/main/screens/Finance/FinanceScreen.js"
click node_budget "https://github.com/zencron/cohab/blob/main/components/finance/BudgetGraph.js"
click node_grouppay "https://github.com/zencron/cohab/blob/main/components/finance/GroupPayCard.js"
click node_roommates "https://github.com/zencron/cohab/blob/main/components/finance/RoommateCard.js"
click node_groupselect "https://github.com/zencron/cohab/blob/main/screens/GroupSelectScreen.js"
click node_addgroup "https://github.com/zencron/cohab/blob/main/components/group/AddGroupModal.js"
click node_joingroup "https://github.com/zencron/cohab/blob/main/components/group/JoinGroupModal.js"
click node_authscreens "https://github.com/zencron/cohab/blob/main/screens/LoginScreen.js"
click node_authservlets "https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/LoginServlet.java"
click node_taskservlets "https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/AddTaskServlet.java"
click node_choreservlets "https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/GetChoresServlet.java"
click node_eventservlets "https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/GetEventsServlet.java"
click node_financeapi "https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/GetBillsServlet.java"
click node_groupapi "https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/AddGroupServlet.java"
click node_profileapi "https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/GetUserProfileServlet.java"
click node_basictext "https://github.com/zencron/cohab/blob/main/components/BasicText.js"
click node_constants "https://github.com/zencron/cohab/blob/main/ConstantHelper.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_loginctx,node_navigation,node_home,node_taskscreen,node_authscreens,node_basictext,node_constants toneBlue
class node_mytasks,node_tasktabs,node_taskcard,node_taskmodal,node_claimmodal,node_chorescreen,node_chorecard,node_choremodal,node_choreedit toneAmber
class node_calendar,node_eventmodal,node_finance,node_budget,node_grouppay,node_roommates,node_groupselect,node_addgroup,node_joingroup toneMint
class node_authservlets,node_taskservlets,node_choreservlets,node_eventservlets,node_financeapi,node_groupapi,node_profileapi toneRose
class node_user toneIndigo
```

## Components

### Mobile app shell

- [App entry](https://github.com/zencron/cohab/blob/main/App.js): `App.js`
- [Login context](https://github.com/zencron/cohab/blob/main/LoginContext.js): `LoginContext.js`
- [Root navigation](https://github.com/zencron/cohab/blob/main/navigation/RootStackScreen.js): `navigation/RootStackScreen.js`
- [Home screen](https://github.com/zencron/cohab/blob/main/screens/HomeScreen.js): `screens/HomeScreen.js`
- [Task screen](https://github.com/zencron/cohab/blob/main/screens/TaskScreen.js): `screens/TaskScreen.js`
- [Login and register](https://github.com/zencron/cohab/blob/main/screens/LoginScreen.js): `screens/LoginScreen.js`
- [Text component](https://github.com/zencron/cohab/blob/main/components/BasicText.js): `components/BasicText.js`
- [Shared constants](https://github.com/zencron/cohab/blob/main/ConstantHelper.js): `ConstantHelper.js`

### Tasks and chores

- [My tasks](https://github.com/zencron/cohab/blob/main/components/task/MyTasks.js): `components/task/MyTasks.js`
- [Task tabs](https://github.com/zencron/cohab/blob/main/components/task/SharedTasks.js): `components/task/SharedTasks.js`
- [Task card](https://github.com/zencron/cohab/blob/main/components/task/TaskCard.js): `components/task/TaskCard.js`
- [Task editor](https://github.com/zencron/cohab/blob/main/components/task/TaskModal.js): `components/task/TaskModal.js`
- [Claim task](https://github.com/zencron/cohab/blob/main/components/task/ClaimTaskSDModal.js): `components/task/ClaimTaskSDModal.js`
- [Chore screen](https://github.com/zencron/cohab/blob/main/screens/ChoreScreen.js): `screens/ChoreScreen.js`
- [Chore card](https://github.com/zencron/cohab/blob/main/components/chore/ChoreCard.js): `components/chore/ChoreCard.js`
- [Chore editor](https://github.com/zencron/cohab/blob/main/components/chore/ChoreModal.js): `components/chore/ChoreModal.js`
- [Edit chore](https://github.com/zencron/cohab/blob/main/components/chore/ChoreModalEDIT.js): `components/chore/ChoreModalEDIT.js`

### Household features

- [Calendar screen](https://github.com/zencron/cohab/blob/main/screens/CalendarScreen.js): `screens/CalendarScreen.js`
- [Event editor](https://github.com/zencron/cohab/blob/main/components/calendar/CalendarModal.js): `components/calendar/CalendarModal.js`
- [Finance screen](https://github.com/zencron/cohab/blob/main/screens/Finance/FinanceScreen.js): `screens/Finance/FinanceScreen.js`
- [Budget graph](https://github.com/zencron/cohab/blob/main/components/finance/BudgetGraph.js): `components/finance/BudgetGraph.js`
- [Group payments](https://github.com/zencron/cohab/blob/main/components/finance/GroupPayCard.js): `components/finance/GroupPayCard.js`
- [Roommate payments](https://github.com/zencron/cohab/blob/main/components/finance/RoommateCard.js): `components/finance/RoommateCard.js`
- [Group selection](https://github.com/zencron/cohab/blob/main/screens/GroupSelectScreen.js): `screens/GroupSelectScreen.js`
- [Create group](https://github.com/zencron/cohab/blob/main/components/group/AddGroupModal.js): `components/group/AddGroupModal.js`
- [Join group](https://github.com/zencron/cohab/blob/main/components/group/JoinGroupModal.js): `components/group/JoinGroupModal.js`

### Tomcat backend

- [Account endpoints](https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/LoginServlet.java): `cohab_tomcat/cohab/WEB-INF/classes/LoginServlet.java`
- [Task endpoints](https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/AddTaskServlet.java): `cohab_tomcat/cohab/WEB-INF/classes/AddTaskServlet.java`
- [Chore endpoints](https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/GetChoresServlet.java): `cohab_tomcat/cohab/WEB-INF/classes/GetChoresServlet.java`
- [Event endpoints](https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/GetEventsServlet.java): `cohab_tomcat/cohab/WEB-INF/classes/GetEventsServlet.java`
- [Bill endpoints](https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/GetBillsServlet.java): `cohab_tomcat/cohab/WEB-INF/classes/GetBillsServlet.java`
- [Group endpoints](https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/AddGroupServlet.java): `cohab_tomcat/cohab/WEB-INF/classes/AddGroupServlet.java`
- [Profile endpoints](https://github.com/zencron/cohab/blob/main/cohab_tomcat/cohab/WEB-INF/classes/GetUserProfileServlet.java): `cohab_tomcat/cohab/WEB-INF/classes/GetUserProfileServlet.java`

### Other components

- **Resident**

## Connections

- Resident → App entry: opens
- App entry → Root navigation: renders (evidence: `App.js`)
- App entry → Login context: provides context (evidence: `App.js`)
- Resident → Task screen: views tasks (evidence: `screens/TaskScreen.js`)
- Task screen → My tasks: renders (evidence: `screens/TaskScreen.js`)
- Task screen → Task tabs: renders (evidence: `screens/TaskScreen.js`)
- My tasks → Task card: renders (evidence: `components/task/MyTasks.js`)
- My tasks → Task editor: opens (evidence: `components/task/MyTasks.js`)
- Task card → Claim task: opens (evidence: `components/task/TaskCard.js`)
- Resident → Home screen: views home (evidence: `screens/HomeScreen.js`)
- Resident → Finance screen: views finances (evidence: `screens/Finance/FinanceScreen.js`)
- Finance screen → Budget graph: renders (evidence: `screens/Finance/FinanceScreen.js`)
- Finance screen → Group payments: renders (evidence: `screens/Finance/FinanceScreen.js`)
- Finance screen → Roommate payments: renders (evidence: `screens/Finance/FinanceScreen.js`)
- Event editor → Text component: renders (evidence: `components/calendar/CalendarModal.js`)
- Edit chore → Shared constants: uses (evidence: `components/chore/ChoreModalEDIT.js`)
