How sofdev005/teamflow-project-management-saas-app works
TeamFlow is a multi-tenant project and task management frontend. Users register or sign in, then use protected dashboard pages to manage projects, work on project Kanban boards, and invite organization or project members. The board supports task creation, editing, deletion, drag-and-drop moves, and graceful handling of missing backend routes. Service modules call the external .NET API through a shared Axios client; auth and preferences also use browser storage. The graph follows documented capabilities where source was not sampled, so some page-to-service links are omitted when not evidenced.
Main entry points: page.tsx Project Kanban board · projectService.ts Project API · taskService.ts Task API · apiClient.ts HTTP client
Components 23
Identity and shell
- Sign in and register
src/app/login/page.tsx - Session provider
src/context/AuthContext.tsx - Protected app shell
src/components/DashboardLayout.tsx - Profile and preferences
src/app/settings/page.tsx - Preference state
src/context/UserPreferencesContext.tsx
Project workspace
- Dashboard overview
src/app/dashboard/page.tsx - Project list
src/app/projects/page.tsx - Project Kanban board
src/app/projects/[id]/page.tsx - Board columns
src/components/BoardColumnContainer.tsx - Task card
src/components/TaskCard.tsx - Task editor drawer
src/components/TaskSideDrawer.tsx
Team management
- Organization team
src/app/team/page.tsx
Client services
- Authentication API
src/services/authService.ts - Project API
src/services/projectService.ts - Board API
src/services/boardService.ts - Task API
src/services/taskService.ts - Organization API
src/services/organizationService.ts - HTTP client
src/lib/apiClient.ts - Modal
src/components/Modal.tsx - Loading indicator
src/components/Spinner.tsx - Domain types
src/types/index.ts
Other components
- User
- TeamFlow .NET API
Connections 35
- User → Sign in and register: signs in
README.md - Sign in and register → Session provider: submits credentials
src/app/login/page.tsx - Session provider → HTTP client: sends auth requests
src/context/AuthContext.tsx - Protected app shell → Session provider: guards session
src/components/DashboardLayout.tsx - User → Protected app shell: opens workspace
README.md - Profile and preferences → Preference state: updates preferences
src/app/settings/page.tsx - Dashboard overview → Project API: loads projects
src/app/dashboard/page.tsx - Dashboard overview → Task API: loads task data
src/app/dashboard/page.tsx - Project list → Project API: manages projects
src/app/projects/page.tsx - Project Kanban board → Project API: loads project
src/app/projects/[id]/page.tsx - Project Kanban board → Board API: loads columns
src/app/projects/[id]/page.tsx - Project Kanban board → Task API: manages tasks
src/app/projects/[id]/page.tsx - Project Kanban board → Organization API: loads members
README.md - Project Kanban board → Board columns: renders columns
src/app/projects/[id]/page.tsx - Board columns → Task card: renders tasks
src/components/BoardColumnContainer.tsx - Project Kanban board → Task editor drawer: opens task editor
src/app/projects/[id]/page.tsx - Task editor drawer → Task API: updates tasks
src/components/TaskSideDrawer.tsx - Organization team → Organization API: loads and invites
src/app/team/page.tsx - Organization team → Project API: assigns project member
src/app/team/page.tsx - Project API → HTTP client: calls endpoints
src/services/projectService.ts - Board API → HTTP client: calls endpoints
src/services/boardService.ts - Task API → HTTP client: calls endpoints
src/services/taskService.ts - Organization API → HTTP client: calls endpoints
src/services/organizationService.ts - HTTP client → TeamFlow .NET API: sends HTTP requests
README.md - Session provider → TeamFlow .NET API: registers and signs in
src/context/AuthContext.tsx - Task API → TeamFlow .NET API: reads and writes tasks
src/services/taskService.ts - Project API → TeamFlow .NET API: reads and writes projects
src/services/projectService.ts - Board API → TeamFlow .NET API: manages columns
README.md - Organization API → TeamFlow .NET API: manages organization members
README.md - Project Kanban board → Preference state: reads board settings
src/app/projects/[id]/page.tsx - Project Kanban board → Modal: shows forms
src/app/projects/[id]/page.tsx - Organization team → Modal: shows invite form
src/app/team/page.tsx - Protected app shell → Loading indicator: shows loading state
src/components/DashboardLayout.tsx - Task API → Domain types: uses task models
src/services/taskService.ts - Project API → Domain types: uses project models
src/services/projectService.ts