# iman-datta/axon-client architecture

> Architecture diagram of the GitHub repository iman-datta/axon-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/iman-datta/axon-client
- Repository: https://github.com/iman-datta/axon-client

## Overview

Axon is a developer-workflow frontend for signing in, choosing a workspace, and managing organizations, projects, tickets, and team activity. The principal workflow routes authenticated users into a workspace and project, where they can browse tickets or use a live Kanban board; adjacent areas cover epics, members, GitHub integrations, and settings. The graph reflects the supplied excerpts and SOURCE INDEX references; most page and feature implementations were not sampled, so their internal interactions are omitted.

Main entry points: [`src/App.jsx`](https://github.com/iman-datta/axon-client/blob/main/src/App.jsx) (Application routes), [`src/utils/fetchWithAuth.js`](https://github.com/iman-datta/axon-client/blob/main/src/utils/fetchWithAuth.js) (Authenticated requests), [`src/components/routing/WorkspaceResolver.jsx`](https://github.com/iman-datta/axon-client/blob/main/src/components/routing/WorkspaceResolver.jsx) (Workspace resolution), [`src/pages/dashboard/Dashboard.jsx`](https://github.com/iman-datta/axon-client/blob/main/src/pages/dashboard/Dashboard.jsx) (Kanban board page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and identity"]
  node_app["Application routes<br/>[App.jsx]"]
  node_landing["Product landing<br/>[LandingPage.jsx]"]
  node_auth["Sign-in and registration<br/>[Auth.jsx]"]
  node_oauth["OAuth sign-in<br/>[OAuth.jsx]"]
  node_onboarding["Profile onboarding<br/>[Onboarding.jsx]"]
end

subgraph group_workspace["Workspace and organization"]
  node_workspace_route["Workspace resolution"]
  node_workspace_loader["Workspace loading"]
  node_organizations["Organization management"]
  node_workspace_settings["Workspace settings"]
end

subgraph group_delivery["Projects and delivery"]
  node_project_pages["Project overview and activity"]
  node_project_settings["Project settings<br/>[Danger.jsx]"]
  node_tickets["Ticket list and details"]
  node_board_page["Kanban board page<br/>[Dashboard.jsx]"]
  node_kanban["Kanban board UI<br/>[KanbanBoard.jsx]"]
  node_epics["Epic management<br/>[EpicsPage.jsx]"]
  node_integrations["Repository integrations"]
  node_my_work["Personal work view<br/>[MyWorkPage.jsx]"]
end

subgraph group_state["Client state and transport"]
  node_ticket_hook["Ticket data hook<br/>[useTickets.js]"]
  node_ticket_service["Ticket API service<br/>[ticketService.js]"]
  node_project_service["Project API service<br/>[projectService.js]"]
  node_workspace_state["Workspace state<br/>[workspaceSlice.js]"]
  node_auth_state["Authentication state<br/>[authSlice.js]"]
  node_auth_transport["Authenticated requests<br/>[fetchWithAuth.js]"]
  node_board_socket["Board live updates"]
end

node_user(("User"))
node_api["Axon API"]
node_realtime["Board WebSocket service"]
node_oauth_providers["Google and GitHub"]

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_auth
node_app -->|"routes to"| node_onboarding
node_app -->|"routes to"| node_workspace_route
node_app -->|"wraps routes"| node_workspace_loader
node_app -->|"routes to"| node_organizations
node_app -->|"routes to"| node_project_pages
node_app -->|"routes to"| node_project_settings
node_app -->|"routes to"| node_tickets
node_app -->|"routes to"| node_board_page
node_app -->|"routes to"| node_epics
node_app -->|"routes to"| node_integrations
node_app -->|"routes to"| node_workspace_settings
node_app -->|"routes to"| node_my_work
node_auth -->|"updates"| node_auth_state
node_auth -->|"authenticates via"| node_api
node_oauth -->|"redirects to"| node_oauth_providers
node_workspace_route -->|"updates"| node_workspace_state
node_workspace_route -->|"fetches through"| node_auth_transport
node_workspace_route -->|"resolves via"| node_api
node_workspace_loader -->|"updates"| node_workspace_state
node_workspace_loader -->|"fetches through"| node_auth_transport
node_workspace_settings -->|"uses"| node_workspace_state
node_workspace_settings -->|"loads through"| node_api
node_board_page -->|"loads tickets"| node_ticket_hook
node_board_page -->|"subscribes to"| node_board_socket
node_board_page -->|"renders"| node_kanban
node_ticket_hook -->|"calls"| node_ticket_service
node_ticket_service -->|"requests through"| node_auth_transport
node_auth_transport -->|"refreshes or clears"| node_auth_state
node_auth_transport -->|"sends requests"| node_api
node_board_socket -->|"receives updates"| node_realtime
node_project_service -->|"requests through"| node_auth_transport
node_auth_state -.->|"stores session from"| node_api

click node_app "https://github.com/iman-datta/axon-client/blob/main/src/App.jsx"
click node_landing "https://github.com/iman-datta/axon-client/blob/main/src/components/landingpage/LandingPage.jsx"
click node_auth "https://github.com/iman-datta/axon-client/blob/main/src/pages/auth/Auth.jsx"
click node_oauth "https://github.com/iman-datta/axon-client/blob/main/src/components/auth/OAuth.jsx"
click node_onboarding "https://github.com/iman-datta/axon-client/blob/main/src/pages/auth/Onboarding.jsx"
click node_workspace_route "https://github.com/iman-datta/axon-client/blob/main/src/components/routing/WorkspaceResolver.jsx"
click node_workspace_loader "https://github.com/iman-datta/axon-client/blob/main/src/components/routing/WorkspaceLoader.jsx"
click node_organizations "https://github.com/iman-datta/axon-client/blob/main/src/pages/organizations/OrganizationOverviewPage.jsx"
click node_workspace_settings "https://github.com/iman-datta/axon-client/blob/main/src/components/routing/WorkspaceSettings.jsx"
click node_project_pages "https://github.com/iman-datta/axon-client/blob/main/src/pages/projects/ProjectActivity.jsx"
click node_project_settings "https://github.com/iman-datta/axon-client/blob/main/src/pages/settings/project/Danger.jsx"
click node_tickets "https://github.com/iman-datta/axon-client/blob/main/src/pages/projects/TicketsTablePage.jsx"
click node_board_page "https://github.com/iman-datta/axon-client/blob/main/src/pages/dashboard/Dashboard.jsx"
click node_kanban "https://github.com/iman-datta/axon-client/blob/main/src/components/kanban/KanbanBoard.jsx"
click node_epics "https://github.com/iman-datta/axon-client/blob/main/src/pages/projects/EpicsPage.jsx"
click node_integrations "https://github.com/iman-datta/axon-client/blob/main/src/pages/projects/IntegrationsPage.jsx"
click node_my_work "https://github.com/iman-datta/axon-client/blob/main/src/components/profile/MyWorkPage.jsx"
click node_ticket_hook "https://github.com/iman-datta/axon-client/blob/main/src/hooks/useTickets.js"
click node_ticket_service "https://github.com/iman-datta/axon-client/blob/main/src/services/ticketService.js"
click node_project_service "https://github.com/iman-datta/axon-client/blob/main/src/services/projectService.js"
click node_workspace_state "https://github.com/iman-datta/axon-client/blob/main/src/redux/slices/workspaceSlice.js"
click node_auth_state "https://github.com/iman-datta/axon-client/blob/main/src/redux/slices/authSlice.js"
click node_auth_transport "https://github.com/iman-datta/axon-client/blob/main/src/utils/fetchWithAuth.js"
click node_board_socket "https://github.com/iman-datta/axon-client/blob/main/src/hooks/useBoardWebSocket.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_landing,node_auth,node_oauth,node_onboarding,node_user toneBlue
class node_workspace_route,node_workspace_loader,node_organizations,node_workspace_settings toneAmber
class node_project_pages,node_project_settings,node_tickets,node_board_page,node_kanban,node_epics,node_integrations,node_my_work,node_api toneMint
class node_ticket_hook,node_ticket_service,node_project_service,node_workspace_state,node_auth_state,node_auth_transport,node_board_socket toneRose
class node_realtime,node_oauth_providers toneIndigo
```

## Components

### Entry and identity

- [Application routes](https://github.com/iman-datta/axon-client/blob/main/src/App.jsx): `src/App.jsx`
- [Product landing](https://github.com/iman-datta/axon-client/blob/main/src/components/landingpage/LandingPage.jsx): `src/components/landingpage/LandingPage.jsx`
- [Sign-in and registration](https://github.com/iman-datta/axon-client/blob/main/src/pages/auth/Auth.jsx): `src/pages/auth/Auth.jsx`
- [OAuth sign-in](https://github.com/iman-datta/axon-client/blob/main/src/components/auth/OAuth.jsx): `src/components/auth/OAuth.jsx`
- [Profile onboarding](https://github.com/iman-datta/axon-client/blob/main/src/pages/auth/Onboarding.jsx): `src/pages/auth/Onboarding.jsx`

### Workspace and organization

- [Workspace resolution](https://github.com/iman-datta/axon-client/blob/main/src/components/routing/WorkspaceResolver.jsx): `src/components/routing/WorkspaceResolver.jsx`
- [Workspace loading](https://github.com/iman-datta/axon-client/blob/main/src/components/routing/WorkspaceLoader.jsx): `src/components/routing/WorkspaceLoader.jsx`
- [Organization management](https://github.com/iman-datta/axon-client/blob/main/src/pages/organizations/OrganizationOverviewPage.jsx): `src/pages/organizations/OrganizationOverviewPage.jsx`
- [Workspace settings](https://github.com/iman-datta/axon-client/blob/main/src/components/routing/WorkspaceSettings.jsx): `src/components/routing/WorkspaceSettings.jsx`

### Projects and delivery

- [Project overview and activity](https://github.com/iman-datta/axon-client/blob/main/src/pages/projects/ProjectActivity.jsx): `src/pages/projects/ProjectActivity.jsx`
- [Project settings](https://github.com/iman-datta/axon-client/blob/main/src/pages/settings/project/Danger.jsx): `src/pages/settings/project/Danger.jsx`
- [Ticket list and details](https://github.com/iman-datta/axon-client/blob/main/src/pages/projects/TicketsTablePage.jsx): `src/pages/projects/TicketsTablePage.jsx`
- [Kanban board page](https://github.com/iman-datta/axon-client/blob/main/src/pages/dashboard/Dashboard.jsx): `src/pages/dashboard/Dashboard.jsx`
- [Kanban board UI](https://github.com/iman-datta/axon-client/blob/main/src/components/kanban/KanbanBoard.jsx): `src/components/kanban/KanbanBoard.jsx`
- [Epic management](https://github.com/iman-datta/axon-client/blob/main/src/pages/projects/EpicsPage.jsx): `src/pages/projects/EpicsPage.jsx`
- [Repository integrations](https://github.com/iman-datta/axon-client/blob/main/src/pages/projects/IntegrationsPage.jsx): `src/pages/projects/IntegrationsPage.jsx`
- [Personal work view](https://github.com/iman-datta/axon-client/blob/main/src/components/profile/MyWorkPage.jsx): `src/components/profile/MyWorkPage.jsx`

### Client state and transport

- [Ticket data hook](https://github.com/iman-datta/axon-client/blob/main/src/hooks/useTickets.js): `src/hooks/useTickets.js`
- [Ticket API service](https://github.com/iman-datta/axon-client/blob/main/src/services/ticketService.js): `src/services/ticketService.js`
- [Project API service](https://github.com/iman-datta/axon-client/blob/main/src/services/projectService.js): `src/services/projectService.js`
- [Workspace state](https://github.com/iman-datta/axon-client/blob/main/src/redux/slices/workspaceSlice.js): `src/redux/slices/workspaceSlice.js`
- [Authentication state](https://github.com/iman-datta/axon-client/blob/main/src/redux/slices/authSlice.js): `src/redux/slices/authSlice.js`
- [Authenticated requests](https://github.com/iman-datta/axon-client/blob/main/src/utils/fetchWithAuth.js): `src/utils/fetchWithAuth.js`
- [Board live updates](https://github.com/iman-datta/axon-client/blob/main/src/hooks/useBoardWebSocket.js): `src/hooks/useBoardWebSocket.js`

### Other components

- **User**
- **Axon API**
- **Board WebSocket service**
- **Google and GitHub**

## Connections

- User → Application routes: opens
- Application routes → Product landing: routes to (evidence: `src/App.jsx`)
- Application routes → Sign-in and registration: routes to (evidence: `src/App.jsx`)
- Application routes → Profile onboarding: routes to (evidence: `src/App.jsx`)
- Application routes → Workspace resolution: routes to (evidence: `src/App.jsx`)
- Application routes → Workspace loading: wraps routes (evidence: `src/App.jsx`)
- Application routes → Organization management: routes to (evidence: `src/App.jsx`)
- Application routes → Project overview and activity: routes to (evidence: `src/App.jsx`)
- Application routes → Project settings: routes to (evidence: `src/App.jsx`)
- Application routes → Ticket list and details: routes to (evidence: `src/App.jsx`)
- Application routes → Kanban board page: routes to (evidence: `src/App.jsx`)
- Application routes → Epic management: routes to (evidence: `src/App.jsx`)
- Application routes → Repository integrations: routes to (evidence: `src/App.jsx`)
- Application routes → Workspace settings: routes to (evidence: `src/App.jsx`)
- Application routes → Personal work view: routes to (evidence: `src/App.jsx`)
- Sign-in and registration → Authentication state: updates (evidence: `src/pages/auth/Auth.jsx`)
- Sign-in and registration → Axon API: authenticates via (evidence: `src/pages/auth/Auth.jsx`)
- OAuth sign-in → Google and GitHub: redirects to (evidence: `src/components/auth/OAuth.jsx`)
- Workspace resolution → Workspace state: updates (evidence: `src/components/routing/WorkspaceResolver.jsx`)
- Workspace resolution → Authenticated requests: fetches through (evidence: `src/components/routing/WorkspaceResolver.jsx`)
- Workspace resolution → Axon API: resolves via (evidence: `src/components/routing/WorkspaceResolver.jsx`)
- Workspace loading → Workspace state: updates (evidence: `src/components/routing/WorkspaceLoader.jsx`)
- Workspace loading → Authenticated requests: fetches through (evidence: `src/components/routing/WorkspaceLoader.jsx`)
- Workspace settings → Workspace state: uses (evidence: `src/components/routing/WorkspaceSettings.jsx`)
- Workspace settings → Axon API: loads through (evidence: `src/components/routing/WorkspaceSettings.jsx`)
- Kanban board page → Ticket data hook: loads tickets (evidence: `src/pages/dashboard/Dashboard.jsx`)
- Kanban board page → Board live updates: subscribes to (evidence: `src/pages/dashboard/Dashboard.jsx`)
- Kanban board page → Kanban board UI: renders (evidence: `src/pages/dashboard/Dashboard.jsx`)
- Ticket data hook → Ticket API service: calls (evidence: `src/hooks/useTickets.js`)
- Ticket API service → Authenticated requests: requests through (evidence: `src/services/ticketService.js`)
- Authenticated requests → Authentication state: refreshes or clears (evidence: `src/utils/fetchWithAuth.js`)
- Authenticated requests → Axon API: sends requests
- Board live updates → Board WebSocket service: receives updates (evidence: `src/hooks/useBoardWebSocket.js`)
- Project API service → Authenticated requests: requests through (evidence: `src/services/projectService.js`)
- Authentication state → Axon API: stores session from
