# tushaar-05/flowpilot architecture

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

- Interactive diagram: https://gitdiagram.com/tushaar-05/flowpilot
- Repository: https://github.com/tushaar-05/flowpilot

## Overview

FlowPilot is a client-only project-management SPA. A user enters through the marketing/auth experience, then reaches a guarded workspace for planning and collaboration; local state is persisted in browser storage while service modules simulate asynchronous APIs. The README documents the broader workspace capabilities, including Kanban, calendar, analytics, profile, and settings. Some page implementations were not sampled, so their internal calls are omitted; the graph uses documented capabilities and only supported routing, context, and storage relationships.

Main entry points: [`src/App.tsx`](https://github.com/tushaar-05/flowpilot/blob/main/src/App.tsx) (SPA router), [`src/context/AppContext.tsx`](https://github.com/tushaar-05/flowpilot/blob/main/src/context/AppContext.tsx) (Workspace state), [`src/context/AuthContext.tsx`](https://github.com/tushaar-05/flowpilot/blob/main/src/context/AuthContext.tsx) (Authentication state), [`src/utils/storage.ts`](https://github.com/tushaar-05/flowpilot/blob/main/src/utils/storage.ts) (Browser storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and routing"]
  node_app["SPA router<br/>[App.tsx]"]
  node_landing["Marketing site<br/>[LandingPage.tsx]"]
  node_authpages["Sign in and register"]
  node_guards["Route guards<br/>[ProtectedRoute.tsx]"]
end

subgraph group_workspace["Project workspace"]
  node_dashboard["Dashboard<br/>[DashboardPage.tsx]"]
  node_projects["Projects<br/>[ProjectsPage.tsx]"]
  node_tasks["Tasks<br/>[TasksPage.tsx]"]
  node_kanban["Kanban board<br/>[KanbanPage.tsx]"]
  node_calendar["Deadline calendar<br/>[CalendarPage.tsx]"]
  node_analytics["Analytics<br/>[AnalyticsPage.tsx]"]
end

subgraph group_collab["Team collaboration"]
  node_team["Team directory<br/>[TeamPage.tsx]"]
  node_activity["Activity timeline<br/>[ActivityPage.tsx]"]
  node_files["File manager<br/>[FilesPage.tsx]"]
  node_notifications["Notifications"]
  node_profile["Profile<br/>[ProfilePage.tsx]"]
  node_settings["Settings<br/>[SettingsPage.tsx]"]
end

subgraph group_state["Client state"]
  node_auth["Authentication state<br/>[AuthContext.tsx]"]
  node_appstate["Workspace state<br/>[AppContext.tsx]"]
  node_storage[("Browser storage<br/>[storage.ts]")]
end

subgraph group_services["Simulated services"]
  node_projectapi["Project service<br/>[projectService.ts]"]
  node_taskapi["Task service<br/>[taskService.ts]"]
  node_userapi["User service<br/>[userService.ts]"]
  node_collabapi["Collaboration services"]
end

node_user(("Team member"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_landing
node_app -->|"routes to"| node_authpages
node_app -->|"dispatches through"| node_guards
node_guards -->|"checks session"| node_auth
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_tasks
node_app -->|"routes to"| node_kanban
node_app -->|"routes to"| node_calendar
node_app -.->|"routes to"| node_projects
node_app -.->|"routes to"| node_analytics
node_app -.->|"routes to"| node_team
node_app -.->|"routes to"| node_activity
node_app -.->|"routes to"| node_files
node_app -.->|"routes to"| node_notifications
node_app -.->|"routes to"| node_profile
node_app -.->|"routes to"| node_settings
node_app -->|"provides"| node_auth
node_app -->|"provides"| node_appstate
node_auth -->|"persists session"| node_storage
node_appstate -->|"persists workspace"| node_storage
node_appstate -->|"invokes"| node_projectapi
node_appstate -->|"invokes"| node_taskapi
node_appstate -->|"invokes"| node_userapi
node_appstate -->|"invokes"| node_collabapi
node_dashboard -->|"reads workspace"| node_appstate
node_tasks -->|"reads and updates"| node_appstate
node_appstate -->|"hydrates from"| node_storage

click node_app "https://github.com/tushaar-05/flowpilot/blob/main/src/App.tsx"
click node_landing "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/LandingPage.tsx"
click node_authpages "https://github.com/tushaar-05/flowpilot/tree/main/src/pages/auth"
click node_guards "https://github.com/tushaar-05/flowpilot/blob/main/src/components/auth/ProtectedRoute.tsx"
click node_dashboard "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/DashboardPage.tsx"
click node_projects "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/ProjectsPage.tsx"
click node_tasks "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/TasksPage.tsx"
click node_kanban "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/KanbanPage.tsx"
click node_calendar "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/CalendarPage.tsx"
click node_analytics "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/AnalyticsPage.tsx"
click node_team "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/TeamPage.tsx"
click node_activity "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/ActivityPage.tsx"
click node_files "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/FilesPage.tsx"
click node_notifications "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/NotificationsPage.tsx"
click node_profile "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/ProfilePage.tsx"
click node_settings "https://github.com/tushaar-05/flowpilot/blob/main/src/pages/SettingsPage.tsx"
click node_auth "https://github.com/tushaar-05/flowpilot/blob/main/src/context/AuthContext.tsx"
click node_appstate "https://github.com/tushaar-05/flowpilot/blob/main/src/context/AppContext.tsx"
click node_storage "https://github.com/tushaar-05/flowpilot/blob/main/src/utils/storage.ts"
click node_projectapi "https://github.com/tushaar-05/flowpilot/blob/main/src/services/projectService.ts"
click node_taskapi "https://github.com/tushaar-05/flowpilot/blob/main/src/services/taskService.ts"
click node_userapi "https://github.com/tushaar-05/flowpilot/blob/main/src/services/userService.ts"
click node_collabapi "https://github.com/tushaar-05/flowpilot/tree/main/src/services"

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_authpages,node_guards toneBlue
class node_dashboard,node_projects,node_tasks,node_kanban,node_calendar,node_analytics toneAmber
class node_team,node_activity,node_files,node_notifications,node_profile,node_settings toneMint
class node_auth,node_appstate,node_storage toneRose
class node_projectapi,node_taskapi,node_userapi,node_collabapi,node_user toneIndigo
```

## Components

### Entry and routing

- [SPA router](https://github.com/tushaar-05/flowpilot/blob/main/src/App.tsx): `src/App.tsx`
- [Marketing site](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/LandingPage.tsx): `src/pages/LandingPage.tsx`
- [Sign in and register](https://github.com/tushaar-05/flowpilot/tree/main/src/pages/auth): `src/pages/auth`
- [Route guards](https://github.com/tushaar-05/flowpilot/blob/main/src/components/auth/ProtectedRoute.tsx): `src/components/auth/ProtectedRoute.tsx`

### Project workspace

- [Dashboard](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/DashboardPage.tsx): `src/pages/DashboardPage.tsx`
- [Projects](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/ProjectsPage.tsx): `src/pages/ProjectsPage.tsx`
- [Tasks](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/TasksPage.tsx): `src/pages/TasksPage.tsx`
- [Kanban board](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/KanbanPage.tsx): `src/pages/KanbanPage.tsx`
- [Deadline calendar](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/CalendarPage.tsx): `src/pages/CalendarPage.tsx`
- [Analytics](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/AnalyticsPage.tsx): `src/pages/AnalyticsPage.tsx`

### Team collaboration

- [Team directory](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/TeamPage.tsx): `src/pages/TeamPage.tsx`
- [Activity timeline](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/ActivityPage.tsx): `src/pages/ActivityPage.tsx`
- [File manager](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/FilesPage.tsx): `src/pages/FilesPage.tsx`
- [Notifications](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/NotificationsPage.tsx): `src/pages/NotificationsPage.tsx`
- [Profile](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/ProfilePage.tsx): `src/pages/ProfilePage.tsx`
- [Settings](https://github.com/tushaar-05/flowpilot/blob/main/src/pages/SettingsPage.tsx): `src/pages/SettingsPage.tsx`

### Client state

- [Authentication state](https://github.com/tushaar-05/flowpilot/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Workspace state](https://github.com/tushaar-05/flowpilot/blob/main/src/context/AppContext.tsx): `src/context/AppContext.tsx`
- [Browser storage](https://github.com/tushaar-05/flowpilot/blob/main/src/utils/storage.ts): `src/utils/storage.ts`

### Simulated services

- [Project service](https://github.com/tushaar-05/flowpilot/blob/main/src/services/projectService.ts): `src/services/projectService.ts`
- [Task service](https://github.com/tushaar-05/flowpilot/blob/main/src/services/taskService.ts): `src/services/taskService.ts`
- [User service](https://github.com/tushaar-05/flowpilot/blob/main/src/services/userService.ts): `src/services/userService.ts`
- [Collaboration services](https://github.com/tushaar-05/flowpilot/tree/main/src/services): `src/services`

### Other components

- **Team member**

## Connections

- Team member → SPA router: opens (evidence: `README.md`)
- SPA router → Marketing site: routes to (evidence: `src/App.tsx`)
- SPA router → Sign in and register: routes to (evidence: `src/App.tsx`)
- SPA router → Route guards: dispatches through (evidence: `src/App.tsx`)
- Route guards → Authentication state: checks session (evidence: `src/components/auth/ProtectedRoute.tsx`)
- SPA router → Dashboard: routes to (evidence: `src/App.tsx`)
- SPA router → Tasks: routes to (evidence: `src/App.tsx`)
- SPA router → Kanban board: routes to (evidence: `src/App.tsx`)
- SPA router → Deadline calendar: routes to (evidence: `src/App.tsx`)
- SPA router → Projects: routes to (evidence: `src/App.tsx`)
- SPA router → Analytics: routes to (evidence: `src/App.tsx`)
- SPA router → Team directory: routes to (evidence: `src/App.tsx`)
- SPA router → Activity timeline: routes to (evidence: `src/App.tsx`)
- SPA router → File manager: routes to (evidence: `src/App.tsx`)
- SPA router → Notifications: routes to (evidence: `src/App.tsx`)
- SPA router → Profile: routes to (evidence: `src/App.tsx`)
- SPA router → Settings: routes to (evidence: `src/App.tsx`)
- SPA router → Authentication state: provides (evidence: `src/App.tsx`)
- SPA router → Workspace state: provides (evidence: `src/App.tsx`)
- Authentication state → Browser storage: persists session (evidence: `src/context/AuthContext.tsx`)
- Workspace state → Browser storage: persists workspace (evidence: `src/context/AppContext.tsx`)
- Workspace state → Project service: invokes (evidence: `src/context/AppContext.tsx`)
- Workspace state → Task service: invokes (evidence: `src/context/AppContext.tsx`)
- Workspace state → User service: invokes (evidence: `src/context/AppContext.tsx`)
- Workspace state → Collaboration services: invokes (evidence: `src/context/AppContext.tsx`)
- Dashboard → Workspace state: reads workspace (evidence: `src/pages/DashboardPage.tsx`)
- Tasks → Workspace state: reads and updates (evidence: `src/pages/TasksPage.tsx`)
- Workspace state → Browser storage: hydrates from (evidence: `README.md`)
