# kramsenhen/apexflow architecture

> Architecture diagram of the GitHub repository kramsenhen/apexflow, 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/kramsenhen/apexflow
- Repository: https://github.com/kramsenhen/apexflow

## Overview

ApexFlow is a collaborative engineering workspace for project planning and team communication. Users sign in, enter a project workspace, and navigate among issue planning, chat, threads, risks, voice, GitHub, activity, and membership features. The app-level component selects the active view; shared authentication and workspace contexts provide user and project state, with Firestore as the persistence layer. The README is empty, so feature coverage is based on the file tree and source index. Some UI-to-data relationships are not excerpted and are therefore omitted.

Main entry points: [`src/App.tsx`](https://github.com/kramsenhen/apexflow/blob/main/src/App.tsx) (Workspace router), [`src/context/WorkspaceContext.tsx`](https://github.com/kramsenhen/apexflow/blob/main/src/context/WorkspaceContext.tsx) (Workspace state), [`src/components/chat/ChatView.tsx`](https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/ChatView.tsx) (Channel chat), [`src/context/VoiceContext.tsx`](https://github.com/kramsenhen/apexflow/blob/main/src/context/VoiceContext.tsx) (Voice state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["Workspace router<br/>[App.tsx]"]
  node_signin["Sign in<br/>[SignInView.tsx]"]
  node_navigation["Project navigation<br/>[ProjectSidebar.tsx]"]
end

subgraph group_planning["Project planning"]
  node_board["Issue board<br/>[BoardView.tsx]"]
  node_backlog["Backlog<br/>[BacklogView.tsx]"]
  node_issue_detail["Issue details"]
  node_risk["Risk management<br/>[RiskSystemView.tsx]"]
  node_risk_form["Risk entry"]
  node_github["GitHub view<br/>[GitHubView.tsx]"]
end

subgraph group_collaboration["Team collaboration"]
  node_threads["Project threads"]
  node_thread_detail["Thread conversation"]
  node_chat["Channel chat<br/>[ChatView.tsx]"]
  node_embed_studio["Embed designer"]
  node_embed_card["Rich embed card<br/>[RichEmbedCard.tsx]"]
  node_embed_toolbar["Embed toolbar"]
  node_gif_picker["GIF picker"]
  node_voice["Voice channels<br/>[VoiceView.tsx]"]
  node_voice_bar["Voice controls"]
  node_activity["Activity feed"]
  node_members["Project members<br/>[MembersView.tsx]"]
end

subgraph group_platform["Shared state and data"]
  node_auth["Authentication state<br/>[AuthContext.tsx]"]
  node_workspace["Workspace state"]
  node_voice_state["Voice state<br/>[VoiceContext.tsx]"]
  node_firebase["Firebase setup<br/>[firebase.ts]"]
  node_firestore[("Firestore")]
  node_embed_utils["Link embed utilities<br/>[linkEmbedUtils.ts]"]
  node_config["Product defaults<br/>[appConfig.ts]"]
end

node_engineer(("Team member"))

node_engineer -->|"signs in"| node_signin
node_app -->|"shows when signed out"| node_signin
node_app -->|"provides auth"| node_auth
node_app -->|"provides workspace"| node_workspace
node_app -->|"provides voice state"| node_voice_state
node_app -->|"routes to"| node_board
node_app -->|"routes to"| node_backlog
node_app -->|"routes to"| node_chat
node_app -->|"routes to"| node_threads
node_app -->|"routes to"| node_risk
node_app -->|"routes to"| node_voice
node_app -->|"routes to"| node_github
node_app -->|"routes to"| node_activity
node_app -->|"routes to"| node_members
node_navigation -->|"uses project state"| node_workspace
node_board -->|"uses project state"| node_workspace
node_backlog -->|"uses project state"| node_workspace
node_issue_detail -->|"uses project state"| node_workspace
node_threads -->|"renders"| node_thread_detail
node_threads -->|"uses project state"| node_workspace
node_thread_detail -->|"renders"| node_embed_card
node_chat -->|"renders"| node_embed_studio
node_chat -->|"renders"| node_embed_card
node_chat -->|"uses"| node_embed_toolbar
node_chat -->|"uses"| node_gif_picker
node_chat -->|"uses project state"| node_workspace
node_risk -->|"opens"| node_risk_form
node_risk -->|"uses project state"| node_workspace
node_voice -->|"uses voice state"| node_voice_state
node_voice_bar -->|"uses voice state"| node_voice_state
node_github -->|"uses project state"| node_workspace
node_activity -->|"reads activity"| node_workspace
node_members -->|"uses project state"| node_workspace
node_auth -->|"uses Firebase"| node_firebase
node_workspace -->|"uses Firestore"| node_firebase
node_voice_state -->|"uses Firestore"| node_firebase
node_firebase -->|"initializes database"| node_firestore
node_risk_form -.->|"uses defaults"| node_config
node_workspace -->|"uses link utilities"| node_embed_utils
node_signin -->|"uses app defaults"| node_config

click node_app "https://github.com/kramsenhen/apexflow/blob/main/src/App.tsx"
click node_signin "https://github.com/kramsenhen/apexflow/blob/main/src/components/auth/SignInView.tsx"
click node_navigation "https://github.com/kramsenhen/apexflow/blob/main/src/components/layout/ProjectSidebar.tsx"
click node_board "https://github.com/kramsenhen/apexflow/blob/main/src/components/board/BoardView.tsx"
click node_backlog "https://github.com/kramsenhen/apexflow/blob/main/src/components/backlog/BacklogView.tsx"
click node_issue_detail "https://github.com/kramsenhen/apexflow/blob/main/src/components/issues/IssueDetailModal.tsx"
click node_threads "https://github.com/kramsenhen/apexflow/blob/main/src/components/threads/ProjectThreadsView.tsx"
click node_thread_detail "https://github.com/kramsenhen/apexflow/blob/main/src/components/threads/ThreadDetailModal.tsx"
click node_chat "https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/ChatView.tsx"
click node_embed_studio "https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/EmbedStudioModal.tsx"
click node_embed_card "https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/RichEmbedCard.tsx"
click node_embed_toolbar "https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/EmbedFormatToolbar.tsx"
click node_gif_picker "https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/GifPickerPopover.tsx"
click node_risk "https://github.com/kramsenhen/apexflow/blob/main/src/components/risk/RiskSystemView.tsx"
click node_risk_form "https://github.com/kramsenhen/apexflow/blob/main/src/components/risk/CreateRiskModal.tsx"
click node_voice "https://github.com/kramsenhen/apexflow/blob/main/src/components/voice/VoiceView.tsx"
click node_voice_bar "https://github.com/kramsenhen/apexflow/blob/main/src/components/voice/VoiceFloatingBar.tsx"
click node_github "https://github.com/kramsenhen/apexflow/blob/main/src/components/github/GitHubView.tsx"
click node_activity "https://github.com/kramsenhen/apexflow/blob/main/src/components/activity/ActivityFeedView.tsx"
click node_members "https://github.com/kramsenhen/apexflow/blob/main/src/components/members/MembersView.tsx"
click node_auth "https://github.com/kramsenhen/apexflow/blob/main/src/context/AuthContext.tsx"
click node_workspace "https://github.com/kramsenhen/apexflow/blob/main/src/context/WorkspaceContext.tsx"
click node_voice_state "https://github.com/kramsenhen/apexflow/blob/main/src/context/VoiceContext.tsx"
click node_firebase "https://github.com/kramsenhen/apexflow/blob/main/src/lib/firebase.ts"
click node_embed_utils "https://github.com/kramsenhen/apexflow/blob/main/src/utils/linkEmbedUtils.ts"
click node_config "https://github.com/kramsenhen/apexflow/blob/main/src/config/appConfig.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_app,node_signin,node_navigation toneBlue
class node_board,node_backlog,node_issue_detail,node_risk,node_risk_form,node_github toneAmber
class node_threads,node_thread_detail,node_chat,node_embed_studio,node_embed_card,node_embed_toolbar,node_gif_picker,node_voice,node_voice_bar,node_activity,node_members toneMint
class node_auth,node_workspace,node_voice_state,node_firebase,node_firestore,node_embed_utils,node_config toneRose
class node_engineer toneIndigo
```

## Components

### Application shell

- [Workspace router](https://github.com/kramsenhen/apexflow/blob/main/src/App.tsx): `src/App.tsx`
- [Sign in](https://github.com/kramsenhen/apexflow/blob/main/src/components/auth/SignInView.tsx): `src/components/auth/SignInView.tsx`
- [Project navigation](https://github.com/kramsenhen/apexflow/blob/main/src/components/layout/ProjectSidebar.tsx): `src/components/layout/ProjectSidebar.tsx`

### Project planning

- [Issue board](https://github.com/kramsenhen/apexflow/blob/main/src/components/board/BoardView.tsx): `src/components/board/BoardView.tsx`
- [Backlog](https://github.com/kramsenhen/apexflow/blob/main/src/components/backlog/BacklogView.tsx): `src/components/backlog/BacklogView.tsx`
- [Issue details](https://github.com/kramsenhen/apexflow/blob/main/src/components/issues/IssueDetailModal.tsx): `src/components/issues/IssueDetailModal.tsx`
- [Risk management](https://github.com/kramsenhen/apexflow/blob/main/src/components/risk/RiskSystemView.tsx): `src/components/risk/RiskSystemView.tsx`
- [Risk entry](https://github.com/kramsenhen/apexflow/blob/main/src/components/risk/CreateRiskModal.tsx): `src/components/risk/CreateRiskModal.tsx`
- [GitHub view](https://github.com/kramsenhen/apexflow/blob/main/src/components/github/GitHubView.tsx): `src/components/github/GitHubView.tsx`

### Team collaboration

- [Project threads](https://github.com/kramsenhen/apexflow/blob/main/src/components/threads/ProjectThreadsView.tsx): `src/components/threads/ProjectThreadsView.tsx`
- [Thread conversation](https://github.com/kramsenhen/apexflow/blob/main/src/components/threads/ThreadDetailModal.tsx): `src/components/threads/ThreadDetailModal.tsx`
- [Channel chat](https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/ChatView.tsx): `src/components/chat/ChatView.tsx`
- [Embed designer](https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/EmbedStudioModal.tsx): `src/components/chat/EmbedStudioModal.tsx`
- [Rich embed card](https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/RichEmbedCard.tsx): `src/components/chat/RichEmbedCard.tsx`
- [Embed toolbar](https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/EmbedFormatToolbar.tsx): `src/components/chat/EmbedFormatToolbar.tsx`
- [GIF picker](https://github.com/kramsenhen/apexflow/blob/main/src/components/chat/GifPickerPopover.tsx): `src/components/chat/GifPickerPopover.tsx`
- [Voice channels](https://github.com/kramsenhen/apexflow/blob/main/src/components/voice/VoiceView.tsx): `src/components/voice/VoiceView.tsx`
- [Voice controls](https://github.com/kramsenhen/apexflow/blob/main/src/components/voice/VoiceFloatingBar.tsx): `src/components/voice/VoiceFloatingBar.tsx`
- [Activity feed](https://github.com/kramsenhen/apexflow/blob/main/src/components/activity/ActivityFeedView.tsx): `src/components/activity/ActivityFeedView.tsx`
- [Project members](https://github.com/kramsenhen/apexflow/blob/main/src/components/members/MembersView.tsx): `src/components/members/MembersView.tsx`

### Shared state and data

- [Authentication state](https://github.com/kramsenhen/apexflow/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Workspace state](https://github.com/kramsenhen/apexflow/blob/main/src/context/WorkspaceContext.tsx): `src/context/WorkspaceContext.tsx`
- [Voice state](https://github.com/kramsenhen/apexflow/blob/main/src/context/VoiceContext.tsx): `src/context/VoiceContext.tsx`
- [Firebase setup](https://github.com/kramsenhen/apexflow/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- **Firestore**
- [Link embed utilities](https://github.com/kramsenhen/apexflow/blob/main/src/utils/linkEmbedUtils.ts): `src/utils/linkEmbedUtils.ts`
- [Product defaults](https://github.com/kramsenhen/apexflow/blob/main/src/config/appConfig.ts): `src/config/appConfig.ts`

### Other components

- **Team member**

## Connections

- Team member → Sign in: signs in
- Workspace router → Sign in: shows when signed out (evidence: `src/App.tsx`)
- Workspace router → Authentication state: provides auth (evidence: `src/App.tsx`)
- Workspace router → Workspace state: provides workspace (evidence: `src/App.tsx`)
- Workspace router → Voice state: provides voice state (evidence: `src/App.tsx`)
- Workspace router → Issue board: routes to (evidence: `src/App.tsx`)
- Workspace router → Backlog: routes to (evidence: `src/App.tsx`)
- Workspace router → Channel chat: routes to (evidence: `src/App.tsx`)
- Workspace router → Project threads: routes to (evidence: `src/App.tsx`)
- Workspace router → Risk management: routes to (evidence: `src/App.tsx`)
- Workspace router → Voice channels: routes to (evidence: `src/App.tsx`)
- Workspace router → GitHub view: routes to (evidence: `src/App.tsx`)
- Workspace router → Activity feed: routes to (evidence: `src/App.tsx`)
- Workspace router → Project members: routes to (evidence: `src/App.tsx`)
- Project navigation → Workspace state: uses project state (evidence: `src/components/layout/ProjectSidebar.tsx`)
- Issue board → Workspace state: uses project state (evidence: `src/components/board/BoardView.tsx`)
- Backlog → Workspace state: uses project state (evidence: `src/components/backlog/BacklogView.tsx`)
- Issue details → Workspace state: uses project state (evidence: `src/components/issues/IssueDetailModal.tsx`)
- Project threads → Thread conversation: renders (evidence: `src/components/threads/ProjectThreadsView.tsx`)
- Project threads → Workspace state: uses project state (evidence: `src/components/threads/ProjectThreadsView.tsx`)
- Thread conversation → Rich embed card: renders (evidence: `src/components/threads/ThreadDetailModal.tsx`)
- Channel chat → Embed designer: renders (evidence: `src/components/chat/ChatView.tsx`)
- Channel chat → Rich embed card: renders (evidence: `src/components/chat/ChatView.tsx`)
- Channel chat → Embed toolbar: uses (evidence: `src/components/chat/ChatView.tsx`)
- Channel chat → GIF picker: uses (evidence: `src/components/chat/ChatView.tsx`)
- Channel chat → Workspace state: uses project state (evidence: `src/components/chat/ChatView.tsx`)
- Risk management → Risk entry: opens (evidence: `src/components/risk/RiskSystemView.tsx`)
- Risk management → Workspace state: uses project state (evidence: `src/components/risk/RiskSystemView.tsx`)
- Voice channels → Voice state: uses voice state (evidence: `src/components/voice/VoiceView.tsx`)
- Voice controls → Voice state: uses voice state (evidence: `src/components/voice/VoiceFloatingBar.tsx`)
- GitHub view → Workspace state: uses project state (evidence: `src/components/github/GitHubView.tsx`)
- Activity feed → Workspace state: reads activity (evidence: `src/components/activity/ActivityFeedView.tsx`)
- Project members → Workspace state: uses project state (evidence: `src/components/members/MembersView.tsx`)
- Authentication state → Firebase setup: uses Firebase (evidence: `src/context/AuthContext.tsx`)
- Workspace state → Firebase setup: uses Firestore (evidence: `src/context/WorkspaceContext.tsx`)
- Voice state → Firebase setup: uses Firestore (evidence: `src/context/VoiceContext.tsx`)
- Firebase setup → Firestore: initializes database (evidence: `src/lib/firebase.ts`)
- Risk entry → Product defaults: uses defaults
- Workspace state → Link embed utilities: uses link utilities (evidence: `src/context/WorkspaceContext.tsx`)
- Sign in → Product defaults: uses app defaults (evidence: `src/components/auth/SignInView.tsx`)
