# dvssray/2026-softwaredesign-midproject architecture

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

- Interactive diagram: https://gitdiagram.com/dvssray/2026-softwaredesign-midproject
- Repository: https://github.com/dvssray/2026-softwaredesign-midproject

## Overview

NTHU Chatroom is a React/Firebase messaging app. Users sign in, choose a global, private, or custom room, and exchange messages and media; group membership and profile features extend that flow. The graph also retains the repository’s separate Firebase database-view page. Relationships are limited to shown imports/calls and README-documented capabilities; some component and hook internals were not sampled, so their connections are not inferred.

Main entry points: [`src/App.jsx`](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/App.jsx) (App shell), [`src/components/Chatroom.jsx`](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/Chatroom.jsx) (Chat room), [`src/firebase.js`](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/firebase.js) (Firebase client), [`src/hooks/useGroups.js`](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useGroups.js) (Group membership)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App Shell"]
  node_app["App shell<br/>[App.jsx]"]
  node_sidebar["Room sidebar"]
  node_featurepage["Feature page<br/>[Feature.jsx]"]
end

subgraph group_identity["Identity &amp; Profiles"]
  node_membership["Membership UI<br/>[Membership.jsx]"]
  node_authhook["Auth state<br/>[useAuth.js]"]
  node_authalt["Auth component<br/>[auth.jsx]"]
  node_profile["Profile editor<br/>[UserProfile.jsx]"]
  node_profilehook["Profile data<br/>[useProfile.js]"]
  node_usershook["User directory<br/>[useUsers.js]"]
end

subgraph group_messaging["Messaging"]
  node_chatroom["Chat room<br/>[Chatroom.jsx]"]
  node_chatdata["Message data<br/>[useChat.js]"]
  node_previews["Previews &amp; alerts"]
  node_canvas["Doodle canvas<br/>[CanvasInput.jsx]"]
  node_sanitize["Text sanitizer<br/>[sanitize.js]"]
  node_compress["Image compressor<br/>[imageCompressor.js]"]
end

subgraph group_groups["Groups &amp; Members"]
  node_groupcreate["Group creation"]
  node_groupshook["Group membership<br/>[useGroups.js]"]
  node_members["Room members"]
  node_memberprofile["Member profile"]
end

subgraph group_firebase["Firebase Services"]
  node_firebase["Firebase client<br/>[firebase.js]"]
  node_rtdb[("Realtime Database")]
  node_dbpage["Database viewer<br/>[database.jsx]"]
  node_storagehook["Media upload hook<br/>[useStorage.js]"]
end

node_user(("Chat user"))
node_browser["Browser notifications"]

node_user -->|"uses"| node_app
node_app -->|"reads auth"| node_authhook
node_app -->|"loads users"| node_usershook
node_app -->|"loads groups"| node_groupshook
node_app -->|"shows signed-out"| node_membership
node_app -->|"opens room"| node_chatroom
node_app -->|"renders rooms"| node_sidebar
node_app -->|"opens profile"| node_profile
node_app -->|"opens group form"| node_groupcreate
node_app -->|"uses alerts"| node_previews
node_user -->|"signs in"| node_membership
node_membership -->|"submits credentials"| node_authhook
node_authhook -->|"uses auth"| node_firebase
node_authhook -->|"writes signup profile"| node_rtdb
node_authalt -->|"uses auth"| node_firebase
node_profile -->|"edits profile"| node_profilehook
node_profilehook -->|"uses database"| node_firebase
node_usershook -->|"uses database"| node_firebase
node_chatroom -->|"reads and writes"| node_chatdata
node_chatdata -->|"uses database"| node_firebase
node_chatroom -->|"sanitizes text"| node_sanitize
node_chatroom -->|"compresses images"| node_compress
node_chatroom -->|"renders canvas"| node_canvas
node_chatroom -->|"opens members"| node_members
node_chatroom -->|"opens member profile"| node_memberprofile
node_previews -->|"uses database"| node_firebase
node_previews -->|"notifies"| node_browser
node_user -->|"sends messages"| node_chatroom
node_chatroom -->|"supports reactions and receipts"| node_chatdata
node_groupcreate -->|"creates group"| node_groupshook
node_groupshook -->|"reads and writes groups"| node_firebase
node_groupshook -->|"stores group events"| node_rtdb
node_groupshook -.->|"posts system messages"| node_chatroom
node_featurepage -->|"renders auth"| node_authalt
node_featurepage -->|"renders database view"| node_dbpage
node_dbpage -->|"reads and writes"| node_rtdb
node_storagehook -->|"uses storage"| node_firebase

click node_app "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/App.jsx"
click node_membership "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/Membership.jsx"
click node_authhook "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useAuth.js"
click node_authalt "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/auth.jsx"
click node_profile "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/UserProfile.jsx"
click node_profilehook "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useProfile.js"
click node_usershook "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useUsers.js"
click node_sidebar "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/UserListSidebar.jsx"
click node_chatroom "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/Chatroom.jsx"
click node_chatdata "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useChat.js"
click node_previews "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useAggregatedPreviews.js"
click node_canvas "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/CanvasInput.jsx"
click node_sanitize "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/utils/sanitize.js"
click node_compress "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/utils/imageCompressor.js"
click node_groupcreate "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/GroupCreateModal.jsx"
click node_groupshook "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useGroups.js"
click node_members "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/ChatMembersModal.jsx"
click node_memberprofile "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/MemberProfileModal.jsx"
click node_firebase "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/firebase.js"
click node_dbpage "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/database.jsx"
click node_featurepage "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/pages/Feature.jsx"
click node_storagehook "https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useStorage.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_sidebar,node_featurepage,node_user,node_browser toneBlue
class node_membership,node_authhook,node_authalt,node_profile,node_profilehook,node_usershook toneAmber
class node_chatroom,node_chatdata,node_previews,node_canvas,node_sanitize,node_compress toneMint
class node_groupcreate,node_groupshook,node_members,node_memberprofile toneRose
class node_firebase,node_rtdb,node_dbpage,node_storagehook toneIndigo
```

## Components

### App Shell

- [App shell](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/App.jsx): `src/App.jsx`
- [Room sidebar](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/UserListSidebar.jsx): `src/components/UserListSidebar.jsx`
- [Feature page](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/pages/Feature.jsx): `src/pages/Feature.jsx`

### Identity & Profiles

- [Membership UI](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/Membership.jsx): `src/components/Membership.jsx`
- [Auth state](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useAuth.js): `src/hooks/useAuth.js`
- [Auth component](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/auth.jsx): `src/components/auth.jsx`
- [Profile editor](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/UserProfile.jsx): `src/components/UserProfile.jsx`
- [Profile data](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useProfile.js): `src/hooks/useProfile.js`
- [User directory](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useUsers.js): `src/hooks/useUsers.js`

### Messaging

- [Chat room](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/Chatroom.jsx): `src/components/Chatroom.jsx`
- [Message data](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useChat.js): `src/hooks/useChat.js`
- [Previews & alerts](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useAggregatedPreviews.js): `src/hooks/useAggregatedPreviews.js`
- [Doodle canvas](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/CanvasInput.jsx): `src/components/CanvasInput.jsx`
- [Text sanitizer](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/utils/sanitize.js): `src/utils/sanitize.js`
- [Image compressor](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/utils/imageCompressor.js): `src/utils/imageCompressor.js`

### Groups & Members

- [Group creation](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/GroupCreateModal.jsx): `src/components/GroupCreateModal.jsx`
- [Group membership](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useGroups.js): `src/hooks/useGroups.js`
- [Room members](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/ChatMembersModal.jsx): `src/components/ChatMembersModal.jsx`
- [Member profile](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/MemberProfileModal.jsx): `src/components/MemberProfileModal.jsx`

### Firebase Services

- [Firebase client](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/firebase.js): `src/firebase.js`
- **Realtime Database**
- [Database viewer](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/components/database.jsx): `src/components/database.jsx`
- [Media upload hook](https://github.com/dvssray/2026-softwaredesign-midproject/blob/main/src/hooks/useStorage.js): `src/hooks/useStorage.js`

### Other components

- **Chat user**
- **Browser notifications**

## Connections

- Chat user → App shell: uses (evidence: `README.md`)
- App shell → Auth state: reads auth (evidence: `src/App.jsx`)
- App shell → User directory: loads users (evidence: `src/App.jsx`)
- App shell → Group membership: loads groups (evidence: `src/App.jsx`)
- App shell → Membership UI: shows signed-out (evidence: `src/App.jsx`)
- App shell → Chat room: opens room (evidence: `src/App.jsx`)
- App shell → Room sidebar: renders rooms (evidence: `src/App.jsx`)
- App shell → Profile editor: opens profile (evidence: `src/App.jsx`)
- App shell → Group creation: opens group form (evidence: `src/App.jsx`)
- App shell → Previews & alerts: uses alerts (evidence: `src/App.jsx`)
- Chat user → Membership UI: signs in (evidence: `README.md`)
- Membership UI → Auth state: submits credentials (evidence: `src/App.jsx`)
- Auth state → Firebase client: uses auth (evidence: `src/hooks/useAuth.js`)
- Auth state → Realtime Database: writes signup profile (evidence: `src/hooks/useAuth.js`)
- Auth component → Firebase client: uses auth (evidence: `src/components/auth.jsx`)
- Profile editor → Profile data: edits profile (evidence: `src/components/UserProfile.jsx`)
- Profile data → Firebase client: uses database (evidence: `src/hooks/useProfile.js`)
- User directory → Firebase client: uses database (evidence: `src/hooks/useUsers.js`)
- Chat room → Message data: reads and writes (evidence: `src/components/Chatroom.jsx`)
- Message data → Firebase client: uses database (evidence: `src/hooks/useChat.js`)
- Chat room → Text sanitizer: sanitizes text (evidence: `src/components/Chatroom.jsx`)
- Chat room → Image compressor: compresses images (evidence: `src/components/Chatroom.jsx`)
- Chat room → Doodle canvas: renders canvas (evidence: `src/components/Chatroom.jsx`)
- Chat room → Room members: opens members (evidence: `src/components/Chatroom.jsx`)
- Chat room → Member profile: opens member profile (evidence: `src/components/Chatroom.jsx`)
- Previews & alerts → Firebase client: uses database (evidence: `src/hooks/useAggregatedPreviews.js`)
- Previews & alerts → Browser notifications: notifies (evidence: `src/hooks/useAggregatedPreviews.js`)
- Chat user → Chat room: sends messages (evidence: `README.md`)
- Chat room → Message data: supports reactions and receipts (evidence: `README.md`)
- Group creation → Group membership: creates group (evidence: `src/App.jsx`)
- Group membership → Firebase client: reads and writes groups (evidence: `src/hooks/useGroups.js`)
- Group membership → Realtime Database: stores group events (evidence: `src/hooks/useGroups.js`)
- Group membership → Chat room: posts system messages
- Feature page → Auth component: renders auth (evidence: `src/pages/Feature.jsx`)
- Feature page → Database viewer: renders database view (evidence: `src/pages/Feature.jsx`)
- Database viewer → Realtime Database: reads and writes (evidence: `src/components/database.jsx`)
- Media upload hook → Firebase client: uses storage (evidence: `src/hooks/useStorage.js`)
