# 3-1-choiinsawman/gesture_client architecture

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

- Interactive diagram: https://gitdiagram.com/3-1-choiinsawman/gesture_client
- Repository: https://github.com/3-1-choiinsawman/gesture_client

## Overview

Gesture is a sign-language communication frontend. Its user-facing flow runs from account creation or login into a profile and home experience, where users can discover or create call rooms and enter a video room. Separate branches cover friends and chat, profile settings, quick slots, meeting notes, and notifications. The graph uses the README and indexed import references; several feature implementations, especially video-room internals and API modules, were not sampled, so their internal links are omitted or marked unverified.

Main entry points: [`src/components/home/CallRoomSection.tsx`](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/home/CallRoomSection.tsx) (Room Discovery), [`src/api/authApi.ts`](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/api/authApi.ts) (Auth API), [`src/app/(main)/auth/profile/page.tsx`](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/(main)/auth/profile/page.tsx) (Profile Page), [`src/components/videoroom/VideoRoom.tsx`](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/videoroom/VideoRoom.tsx) (Video Room)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_signup["Signup Flow<br/>[page.tsx]"]
  node_signup_email["Email Verification<br/>[Step1Email.tsx]"]
  node_signup_profile["Profile Setup<br/>[Step3Profile.tsx]"]
  node_login["Login Page<br/>[page.tsx]"]
  node_auth_hook["Auth Actions<br/>[useAuth.ts]"]
  node_auth_api["Auth API<br/>[authApi.ts]"]
end

subgraph group_discovery["Home And Rooms"]
  node_home["Home Page<br/>[page.tsx]"]
  node_room_section["Room Discovery"]
  node_room_modals["Room Actions"]
  node_room_store[("Room State<br/>[callRoomStore.ts]")]
  node_call_page["Call Page<br/>[page.tsx]"]
end

subgraph group_conversation["Communication"]
  node_room_entry["Room Entry<br/>[page.tsx]"]
  node_video_room["Video Room<br/>[VideoRoom.tsx]"]
  node_webrtc["WebRTC Media<br/>[useWebRTC.ts]"]
  node_sign_language["Sign Recognition<br/>[useSignLanguage.ts]"]
  node_speech_text["Speech To Text<br/>[useSpeechToText.ts]"]
  node_friends["Friends<br/>[FriendsPage.tsx]"]
  node_dm_chat["Direct Chat<br/>[ChatWindow.tsx]"]
  node_dm_socket["Chat Socket<br/>[useDmChatSocket.ts]"]
  node_chat_state[("Chat State<br/>[chatStore.ts]")]
end

subgraph group_profile["Profile And Preferences"]
  node_profile_page["Profile Page<br/>[page.tsx]"]
  node_profile_edit["Profile Editor<br/>[page.tsx]"]
  node_profile_hook["Profile Actions<br/>[useProfile.ts]"]
  node_quick_slots["Sign Quick Slots<br/>[QuickSlots.tsx]"]
  node_meeting_notes["Meeting Notes<br/>[MeetingNotes.tsx]"]
  node_notifications["Notifications"]
end

subgraph group_shared["Shared Client Layer"]
  node_auth_state[("Auth State<br/>[authStore.ts]")]
  node_api_client["HTTP Client<br/>[axiosInstance.ts]"]
  node_cookies["Cookie Helpers<br/>[cookie.ts]"]
end

node_visitor(("Visitor"))
node_backend{{"Service Backend"}}

node_visitor -->|"registers"| node_signup
node_visitor -->|"signs in"| node_login
node_signup -->|"renders"| node_signup_email
node_signup -->|"renders"| node_signup_profile
node_signup_email -->|"verifies email"| node_auth_api
node_signup_profile -->|"registers account"| node_auth_api
node_login -->|"submits credentials"| node_auth_hook
node_auth_hook -->|"authenticates"| node_auth_api
node_auth_hook -->|"updates user"| node_auth_state
node_auth_api -->|"sends requests"| node_api_client
node_auth_api -->|"stores token"| node_cookies
node_api_client -->|"reads tokens"| node_cookies
node_home -->|"renders"| node_room_section
node_call_page -->|"renders"| node_room_section
node_room_section -->|"loads rooms"| node_room_store
node_room_section -->|"opens room actions"| node_room_modals
node_room_section -.->|"requests room data"| node_backend
node_room_entry -->|"renders"| node_video_room
node_video_room -.->|"uses media transport"| node_webrtc
node_video_room -.->|"uses recognition"| node_sign_language
node_video_room -.->|"uses transcription"| node_speech_text
node_visitor -->|"manages friends"| node_friends
node_friends -.->|"opens chat"| node_dm_chat
node_dm_chat -.->|"uses live messaging"| node_dm_socket
node_dm_socket -->|"gets valid token"| node_api_client
node_profile_page -.->|"offers editing"| node_profile_edit
node_profile_edit -.->|"updates profile"| node_profile_hook
node_profile_page -->|"renders"| node_quick_slots
node_profile_page -->|"renders"| node_meeting_notes
node_profile_page -->|"renders"| node_notifications
node_quick_slots -.->|"loads slot data"| node_backend
node_meeting_notes -.->|"loads notes"| node_backend
node_notifications -.->|"loads settings"| node_backend

click node_signup "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/auth/signup/page.tsx"
click node_signup_email "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/signup/Step1Email.tsx"
click node_signup_profile "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/signup/Step3Profile.tsx"
click node_login "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/auth/login/page.tsx"
click node_auth_hook "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/hooks/useAuth.ts"
click node_auth_api "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/api/authApi.ts"
click node_auth_state "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/store/authStore.ts"
click node_home "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/(main)/page.tsx"
click node_room_section "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/home/CallRoomSection.tsx"
click node_room_modals "https://github.com/3-1-choiinsawman/gesture_client/tree/main/src/components/callroom"
click node_room_store "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/store/callRoomStore.ts"
click node_call_page "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/(main)/call/page.tsx"
click node_room_entry "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/room/page.tsx"
click node_video_room "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/videoroom/VideoRoom.tsx"
click node_webrtc "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/videoroom/useWebRTC.ts"
click node_sign_language "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/videoroom/useSignLanguage.ts"
click node_speech_text "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/videoroom/useSpeechToText.ts"
click node_friends "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/friends/FriendsPage.tsx"
click node_dm_chat "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/friends/chat/ChatWindow.tsx"
click node_dm_socket "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/friends/chat/useDmChatSocket.ts"
click node_chat_state "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/store/chatStore.ts"
click node_profile_page "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/(main)/auth/profile/page.tsx"
click node_profile_edit "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/(main)/auth/profile/edit/page.tsx"
click node_profile_hook "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/hooks/useProfile.ts"
click node_quick_slots "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/profile/QuickSlots.tsx"
click node_meeting_notes "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/profile/MeetingNotes.tsx"
click node_notifications "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/profile/NotificationSettings.tsx"
click node_api_client "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/api/axiosInstance.ts"
click node_cookies "https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/lib/cookie.ts"

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_signup,node_signup_email,node_signup_profile,node_login,node_auth_hook,node_auth_api toneBlue
class node_home,node_room_section,node_room_modals,node_room_store,node_call_page toneAmber
class node_room_entry,node_video_room,node_webrtc,node_sign_language,node_speech_text,node_friends,node_dm_chat,node_dm_socket,node_chat_state toneMint
class node_profile_page,node_profile_edit,node_profile_hook,node_quick_slots,node_meeting_notes,node_notifications toneRose
class node_auth_state,node_api_client,node_cookies,node_visitor,node_backend toneIndigo
```

## Components

### Identity

- [Signup Flow](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/auth/signup/page.tsx): `src/app/auth/signup/page.tsx`
- [Email Verification](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/signup/Step1Email.tsx): `src/components/signup/Step1Email.tsx`
- [Profile Setup](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/signup/Step3Profile.tsx): `src/components/signup/Step3Profile.tsx`
- [Login Page](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/auth/login/page.tsx): `src/app/auth/login/page.tsx`
- [Auth Actions](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/hooks/useAuth.ts): `src/hooks/useAuth.ts`
- [Auth API](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/api/authApi.ts): `src/api/authApi.ts`

### Home And Rooms

- [Home Page](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/(main)/page.tsx): `src/app/(main)/page.tsx`
- [Room Discovery](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/home/CallRoomSection.tsx): `src/components/home/CallRoomSection.tsx`
- [Room Actions](https://github.com/3-1-choiinsawman/gesture_client/tree/main/src/components/callroom): `src/components/callroom`
- [Room State](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/store/callRoomStore.ts): `src/store/callRoomStore.ts`
- [Call Page](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/(main)/call/page.tsx): `src/app/(main)/call/page.tsx`

### Communication

- [Room Entry](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/room/page.tsx): `src/app/room/page.tsx`
- [Video Room](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/videoroom/VideoRoom.tsx): `src/components/videoroom/VideoRoom.tsx`
- [WebRTC Media](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/videoroom/useWebRTC.ts): `src/components/videoroom/useWebRTC.ts`
- [Sign Recognition](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/videoroom/useSignLanguage.ts): `src/components/videoroom/useSignLanguage.ts`
- [Speech To Text](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/videoroom/useSpeechToText.ts): `src/components/videoroom/useSpeechToText.ts`
- [Friends](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/friends/FriendsPage.tsx): `src/components/friends/FriendsPage.tsx`
- [Direct Chat](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/friends/chat/ChatWindow.tsx): `src/components/friends/chat/ChatWindow.tsx`
- [Chat Socket](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/friends/chat/useDmChatSocket.ts): `src/components/friends/chat/useDmChatSocket.ts`
- [Chat State](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/store/chatStore.ts): `src/store/chatStore.ts`

### Profile And Preferences

- [Profile Page](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/(main)/auth/profile/page.tsx): `src/app/(main)/auth/profile/page.tsx`
- [Profile Editor](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/app/(main)/auth/profile/edit/page.tsx): `src/app/(main)/auth/profile/edit/page.tsx`
- [Profile Actions](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/hooks/useProfile.ts): `src/hooks/useProfile.ts`
- [Sign Quick Slots](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/profile/QuickSlots.tsx): `src/components/profile/QuickSlots.tsx`
- [Meeting Notes](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/profile/MeetingNotes.tsx): `src/components/profile/MeetingNotes.tsx`
- [Notifications](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/components/profile/NotificationSettings.tsx): `src/components/profile/NotificationSettings.tsx`

### Shared Client Layer

- [Auth State](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/store/authStore.ts): `src/store/authStore.ts`
- [HTTP Client](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/api/axiosInstance.ts): `src/api/axiosInstance.ts`
- [Cookie Helpers](https://github.com/3-1-choiinsawman/gesture_client/blob/main/src/lib/cookie.ts): `src/lib/cookie.ts`

### Other components

- **Visitor**
- **Service Backend**

## Connections

- Visitor → Signup Flow: registers (evidence: `README.md`)
- Visitor → Login Page: signs in (evidence: `README.md`)
- Signup Flow → Email Verification: renders (evidence: `src/app/auth/signup/page.tsx`)
- Signup Flow → Profile Setup: renders (evidence: `src/app/auth/signup/page.tsx`)
- Email Verification → Auth API: verifies email (evidence: `src/components/signup/Step1Email.tsx`)
- Profile Setup → Auth API: registers account (evidence: `src/components/signup/Step3Profile.tsx`)
- Login Page → Auth Actions: submits credentials (evidence: `src/app/auth/login/page.tsx`)
- Auth Actions → Auth API: authenticates (evidence: `src/hooks/useAuth.ts`)
- Auth Actions → Auth State: updates user (evidence: `src/hooks/useAuth.ts`)
- Auth API → HTTP Client: sends requests (evidence: `src/api/authApi.ts`)
- Auth API → Cookie Helpers: stores token (evidence: `src/api/authApi.ts`)
- HTTP Client → Cookie Helpers: reads tokens (evidence: `src/api/axiosInstance.ts`)
- Home Page → Room Discovery: renders (evidence: `src/app/(main)/page.tsx`)
- Call Page → Room Discovery: renders (evidence: `src/app/(main)/call/page.tsx`)
- Room Discovery → Room State: loads rooms (evidence: `src/components/home/CallRoomSection.tsx`)
- Room Discovery → Room Actions: opens room actions (evidence: `src/components/home/CallRoomSection.tsx`)
- Room Discovery → Service Backend: requests room data
- Room Entry → Video Room: renders (evidence: `src/app/room/page.tsx`)
- Video Room → WebRTC Media: uses media transport
- Video Room → Sign Recognition: uses recognition
- Video Room → Speech To Text: uses transcription
- Visitor → Friends: manages friends (evidence: `README.md`)
- Friends → Direct Chat: opens chat
- Direct Chat → Chat Socket: uses live messaging
- Chat Socket → HTTP Client: gets valid token (evidence: `src/components/friends/chat/useDmChatSocket.ts`)
- Profile Page → Profile Editor: offers editing
- Profile Editor → Profile Actions: updates profile
- Profile Page → Sign Quick Slots: renders (evidence: `src/app/(main)/auth/profile/page.tsx`)
- Profile Page → Meeting Notes: renders (evidence: `src/app/(main)/auth/profile/page.tsx`)
- Profile Page → Notifications: renders (evidence: `src/app/(main)/auth/profile/page.tsx`)
- Sign Quick Slots → Service Backend: loads slot data
- Meeting Notes → Service Backend: loads notes
- Notifications → Service Backend: loads settings
