# gitkrishanu/devboard architecture

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

- Interactive diagram: https://gitdiagram.com/gitkrishanu/devboard
- Repository: https://github.com/gitkrishanu/devboard

## Overview

DevBoard is a project-and-task dashboard: users view workspace progress, open a project, browse tasks in a board or list, create tasks, move tasks between statuses, and search. React data hooks call the Go API through the documented /api gateway; the backend reads and writes Postgres. The README also documents project creation and a health endpoint. Edges reflect excerpted imports/calls or README wiring; backend internals beyond the sampled evidence are represented at the API boundary.

Main entry points: [`frontend/src/hooks/useTasks.js`](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/hooks/useTasks.js) (Task data hooks), [`frontend/src/pages/ProjectPage.jsx`](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/pages/ProjectPage.jsx) (Project workspace), [`frontend/src/App.jsx`](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/App.jsx) (App routing), [`frontend/src/components/layout/Topbar.jsx`](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/Topbar.jsx) (Topbar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Dashboard frontend"]
  node_app_entry["React entry<br/>[main.jsx]"]
  node_routing["App routing<br/>[App.jsx]"]
  node_app_shell["App shell<br/>[AppShell.jsx]"]
  node_sidebar["Sidebar<br/>[Sidebar.jsx]"]
  node_topbar["Topbar<br/>[Topbar.jsx]"]
  node_command_bar["Task search<br/>[CommandBar.jsx]"]
  node_profile_menu["Profile menu<br/>[ProfileMenu.jsx]"]
  node_theme_toggle["Theme toggle<br/>[ThemeToggle.jsx]"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
end

subgraph group_task_ui["Task workflow UI"]
  node_project_page["Project workspace<br/>[ProjectPage.jsx]"]
  node_task_hooks["Task data hooks<br/>[useTasks.js]"]
  node_api_client["Fetch API client<br/>[client.js]"]
  node_kanban["Kanban board<br/>[KanbanBoard.jsx]"]
  node_task_list["Task list<br/>[TaskList.jsx]"]
  node_task_card["Task card<br/>[TaskCard.jsx]"]
  node_task_create["Task creation"]
end

subgraph group_backend["API and data"]
  node_backend_api["Go REST API<br/>[main.go]"]
end

subgraph group_database["Postgres storage"]
  node_postgres[("Postgres database<br/>[01_schema.sql]")]
  node_seed_data["Example seed data<br/>[02_seed.sql]"]
end

node_user(("Workspace user"))

node_user -->|"opens dashboard"| node_app_entry
node_app_entry -->|"renders"| node_routing
node_routing -->|"routes through"| node_app_shell
node_routing -->|"routes to"| node_dashboard
node_routing -->|"routes to"| node_project_page
node_app_shell -->|"renders"| node_sidebar
node_app_shell -->|"renders"| node_topbar
node_topbar -->|"renders"| node_command_bar
node_topbar -->|"renders"| node_profile_menu
node_topbar -->|"renders"| node_theme_toggle
node_sidebar -->|"reads task data"| node_task_hooks
node_dashboard -->|"loads projects and tasks"| node_task_hooks
node_project_page -->|"loads project tasks"| node_task_hooks
node_project_page -->|"renders board"| node_kanban
node_project_page -->|"renders list"| node_task_list
node_project_page -->|"renders creation form"| node_task_create
node_kanban -->|"renders cards"| node_task_card
node_kanban -->|"updates task status"| node_task_hooks
node_task_list -->|"renders cards"| node_task_card
node_task_create -->|"creates task"| node_task_hooks
node_task_hooks -->|"calls API"| node_api_client
node_command_bar -->|"searches tasks"| node_api_client
node_api_client -->|"sends /api requests"| node_backend_api
node_backend_api -->|"reads and writes"| node_postgres
node_seed_data -->|"initializes examples"| node_postgres

click node_app_entry "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/main.jsx"
click node_routing "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/App.jsx"
click node_app_shell "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/AppShell.jsx"
click node_sidebar "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/Sidebar.jsx"
click node_topbar "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/Topbar.jsx"
click node_command_bar "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/CommandBar.jsx"
click node_profile_menu "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/ProfileMenu.jsx"
click node_theme_toggle "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/ThemeToggle.jsx"
click node_dashboard "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/pages/DashboardPage.jsx"
click node_project_page "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/pages/ProjectPage.jsx"
click node_task_hooks "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/hooks/useTasks.js"
click node_api_client "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/api/client.js"
click node_kanban "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/tasks/KanbanBoard.jsx"
click node_task_list "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/tasks/TaskList.jsx"
click node_task_card "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/tasks/TaskCard.jsx"
click node_task_create "https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/tasks/TaskCreateModal.jsx"
click node_backend_api "https://github.com/gitkrishanu/devboard/blob/master/backend/main.go"
click node_postgres "https://github.com/gitkrishanu/devboard/blob/master/init/postgres/01_schema.sql"
click node_seed_data "https://github.com/gitkrishanu/devboard/blob/master/init/postgres/02_seed.sql"

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_entry,node_routing,node_app_shell,node_sidebar,node_topbar,node_command_bar,node_profile_menu,node_theme_toggle,node_dashboard,node_user toneBlue
class node_project_page,node_task_hooks,node_api_client,node_kanban,node_task_list,node_task_card,node_task_create toneAmber
class node_backend_api toneMint
class node_postgres,node_seed_data toneRose
```

## Components

### Dashboard frontend

- [React entry](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/main.jsx): `frontend/src/main.jsx`
- [App routing](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [App shell](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/AppShell.jsx): `frontend/src/components/layout/AppShell.jsx`
- [Sidebar](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/Sidebar.jsx): `frontend/src/components/layout/Sidebar.jsx`
- [Topbar](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/Topbar.jsx): `frontend/src/components/layout/Topbar.jsx`
- [Task search](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/CommandBar.jsx): `frontend/src/components/layout/CommandBar.jsx`
- [Profile menu](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/ProfileMenu.jsx): `frontend/src/components/layout/ProfileMenu.jsx`
- [Theme toggle](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/layout/ThemeToggle.jsx): `frontend/src/components/layout/ThemeToggle.jsx`
- [Dashboard](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`

### Task workflow UI

- [Project workspace](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/pages/ProjectPage.jsx): `frontend/src/pages/ProjectPage.jsx`
- [Task data hooks](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/hooks/useTasks.js): `frontend/src/hooks/useTasks.js`
- [Fetch API client](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/api/client.js): `frontend/src/api/client.js`
- [Kanban board](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/tasks/KanbanBoard.jsx): `frontend/src/components/tasks/KanbanBoard.jsx`
- [Task list](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/tasks/TaskList.jsx): `frontend/src/components/tasks/TaskList.jsx`
- [Task card](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/tasks/TaskCard.jsx): `frontend/src/components/tasks/TaskCard.jsx`
- [Task creation](https://github.com/gitkrishanu/devboard/blob/master/frontend/src/components/tasks/TaskCreateModal.jsx): `frontend/src/components/tasks/TaskCreateModal.jsx`

### API and data

- [Go REST API](https://github.com/gitkrishanu/devboard/blob/master/backend/main.go): `backend/main.go`

### Postgres storage

- [Postgres database](https://github.com/gitkrishanu/devboard/blob/master/init/postgres/01_schema.sql): `init/postgres/01_schema.sql`
- [Example seed data](https://github.com/gitkrishanu/devboard/blob/master/init/postgres/02_seed.sql): `init/postgres/02_seed.sql`

### Other components

- **Workspace user**

## Connections

- Workspace user → React entry: opens dashboard (evidence: `README.md`)
- React entry → App routing: renders (evidence: `frontend/src/main.jsx`)
- App routing → App shell: routes through (evidence: `frontend/src/App.jsx`)
- App routing → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Project workspace: routes to (evidence: `frontend/src/App.jsx`)
- App shell → Sidebar: renders (evidence: `frontend/src/components/layout/AppShell.jsx`)
- App shell → Topbar: renders (evidence: `frontend/src/components/layout/AppShell.jsx`)
- Topbar → Task search: renders (evidence: `frontend/src/components/layout/Topbar.jsx`)
- Topbar → Profile menu: renders (evidence: `frontend/src/components/layout/Topbar.jsx`)
- Topbar → Theme toggle: renders (evidence: `frontend/src/components/layout/Topbar.jsx`)
- Sidebar → Task data hooks: reads task data (evidence: `frontend/src/components/layout/Sidebar.jsx`)
- Dashboard → Task data hooks: loads projects and tasks (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Project workspace → Task data hooks: loads project tasks (evidence: `frontend/src/pages/ProjectPage.jsx`)
- Project workspace → Kanban board: renders board (evidence: `frontend/src/pages/ProjectPage.jsx`)
- Project workspace → Task list: renders list (evidence: `frontend/src/pages/ProjectPage.jsx`)
- Project workspace → Task creation: renders creation form (evidence: `frontend/src/pages/ProjectPage.jsx`)
- Kanban board → Task card: renders cards (evidence: `frontend/src/components/tasks/KanbanBoard.jsx`)
- Kanban board → Task data hooks: updates task status (evidence: `frontend/src/components/tasks/KanbanBoard.jsx`)
- Task list → Task card: renders cards (evidence: `frontend/src/components/tasks/TaskList.jsx`)
- Task creation → Task data hooks: creates task (evidence: `frontend/src/components/tasks/TaskCreateModal.jsx`)
- Task data hooks → Fetch API client: calls API (evidence: `frontend/src/hooks/useTasks.js`)
- Task search → Fetch API client: searches tasks (evidence: `frontend/src/components/layout/CommandBar.jsx`)
- Fetch API client → Go REST API: sends /api requests (evidence: `README.md`)
- Go REST API → Postgres database: reads and writes (evidence: `README.md`)
- Example seed data → Postgres database: initializes examples (evidence: `README.md`)
