# carleswebdev/tim2kanban architecture

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

## Overview

The README describes a Kanban task-management app with a Zustand store and a Hono catch-all API, but the sampled homepage is still the default Next.js starter page and the API, store, data, and type files are empty in the excerpts. The graph distinguishes that documented product shape from the inspected runtime: Kanban UI and backend links are unverified, so they are dashed and uncited. The UI primitives and root layout are present, but no task workflow can be confirmed from the supplied source.

Main entry points: [`src/components/kanban/KanbanBoard.tsx`](https://github.com/carleswebdev/tim2kanban/blob/main/src/components/kanban/KanbanBoard.tsx) (Kanban board), [`src/app/page.tsx`](https://github.com/carleswebdev/tim2kanban/blob/main/src/app/page.tsx) (Starter homepage), [`src/components/kanban/TaskCard.tsx`](https://github.com/carleswebdev/tim2kanban/blob/main/src/components/kanban/TaskCard.tsx) (Task card), [`src/components/kanban/TaskDialog.tsx`](https://github.com/carleswebdev/tim2kanban/blob/main/src/components/kanban/TaskDialog.tsx) (Task editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Kanban product"]
  node_board["Kanban board<br/>[KanbanBoard.tsx]"]
  node_taskcard["Task card<br/>[TaskCard.tsx]"]
  node_taskdialog["Task editor<br/>[TaskDialog.tsx]"]
  node_kanbanstate["Task state<br/>[useKanbanStore.ts]"]
  node_initialdata["Initial tasks<br/>[kanban.ts]"]
  node_tasktypes["Task types<br/>[kanban.ts]"]
end

subgraph group_frontend["Web interface"]
  node_home["Starter homepage<br/>[page.tsx]"]
  node_layout["Root layout<br/>[layout.tsx]"]
  node_ui["UI primitives"]
  node_button["Button primitive<br/>[button.tsx]"]
end

subgraph group_backend["API backend"]
  node_api["Hono API route<br/>[route.ts]"]
end

node_visitor(("Browser user"))

node_visitor -->|"opens"| node_home
node_home -->|"renders within"| node_layout
node_home -.->|"would render"| node_board
node_board -.->|"would render"| node_taskcard
node_board -.->|"would open"| node_taskdialog
node_board -.->|"would use"| node_kanbanstate
node_kanbanstate -.->|"may initialize from"| node_initialdata
node_taskdialog -.->|"would use"| node_tasktypes
node_taskcard -.->|"would use"| node_tasktypes
node_ui -->|"includes"| node_button

click node_home "https://github.com/carleswebdev/tim2kanban/blob/main/src/app/page.tsx"
click node_layout "https://github.com/carleswebdev/tim2kanban/blob/main/src/app/layout.tsx"
click node_board "https://github.com/carleswebdev/tim2kanban/blob/main/src/components/kanban/KanbanBoard.tsx"
click node_taskcard "https://github.com/carleswebdev/tim2kanban/blob/main/src/components/kanban/TaskCard.tsx"
click node_taskdialog "https://github.com/carleswebdev/tim2kanban/blob/main/src/components/kanban/TaskDialog.tsx"
click node_kanbanstate "https://github.com/carleswebdev/tim2kanban/blob/main/src/store/useKanbanStore.ts"
click node_initialdata "https://github.com/carleswebdev/tim2kanban/blob/main/src/data/kanban.ts"
click node_tasktypes "https://github.com/carleswebdev/tim2kanban/blob/main/src/types/kanban.ts"
click node_api "https://github.com/carleswebdev/tim2kanban/blob/main/src/app/api/%5B%5B...route%5D%5D/route.ts"
click node_ui "https://github.com/carleswebdev/tim2kanban/tree/main/src/components/ui"
click node_button "https://github.com/carleswebdev/tim2kanban/blob/main/src/components/ui/button.tsx"

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_board,node_taskcard,node_taskdialog,node_kanbanstate,node_initialdata,node_tasktypes,node_visitor toneBlue
class node_home,node_layout,node_ui,node_button toneAmber
class node_api toneMint
```

## Components

### Kanban product

- [Kanban board](https://github.com/carleswebdev/tim2kanban/blob/main/src/components/kanban/KanbanBoard.tsx): `src/components/kanban/KanbanBoard.tsx`
- [Task card](https://github.com/carleswebdev/tim2kanban/blob/main/src/components/kanban/TaskCard.tsx): `src/components/kanban/TaskCard.tsx`
- [Task editor](https://github.com/carleswebdev/tim2kanban/blob/main/src/components/kanban/TaskDialog.tsx): `src/components/kanban/TaskDialog.tsx`
- [Task state](https://github.com/carleswebdev/tim2kanban/blob/main/src/store/useKanbanStore.ts): `src/store/useKanbanStore.ts`
- [Initial tasks](https://github.com/carleswebdev/tim2kanban/blob/main/src/data/kanban.ts): `src/data/kanban.ts`
- [Task types](https://github.com/carleswebdev/tim2kanban/blob/main/src/types/kanban.ts): `src/types/kanban.ts`

### Web interface

- [Starter homepage](https://github.com/carleswebdev/tim2kanban/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Root layout](https://github.com/carleswebdev/tim2kanban/blob/main/src/app/layout.tsx): `src/app/layout.tsx`
- [UI primitives](https://github.com/carleswebdev/tim2kanban/tree/main/src/components/ui): `src/components/ui`
- [Button primitive](https://github.com/carleswebdev/tim2kanban/blob/main/src/components/ui/button.tsx): `src/components/ui/button.tsx`

### API backend

- [Hono API route](https://github.com/carleswebdev/tim2kanban/blob/main/src/app/api/%5B%5B...route%5D%5D/route.ts): `src/app/api/[[...route]]/route.ts`

### Other components

- **Browser user**

## Connections

- Browser user → Starter homepage: opens (evidence: `src/app/page.tsx`)
- Starter homepage → Root layout: renders within (evidence: `src/app/layout.tsx`)
- Starter homepage → Kanban board: would render
- Kanban board → Task card: would render
- Kanban board → Task editor: would open
- Kanban board → Task state: would use
- Task state → Initial tasks: may initialize from
- Task editor → Task types: would use
- Task card → Task types: would use
- UI primitives → Button primitive: includes (evidence: `src/components/ui/button.tsx`)
