# 1711shashank/taskboards-app architecture

> Architecture diagram of the GitHub repository 1711shashank/taskboards-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1711shashank/taskboards-app
- Repository: https://github.com/1711shashank/taskboards-app

## Overview

##### Project Type and Purpose
- Full-stack task management application
- Next.js 15 with built-in API routes serving as backend
- Client-side UI built with React, TypeScript and Tailwind CSS
- State management via Redux Toolkit
- Authentication using JWT and bcryptjs
- In-memory JSON storage for boards and tasks

##### Main Components
- Frontend (Client)
– Next.js App (pages under src/app)
– React components (src/components)
– Redux store (src/store) with authSlice, boardSlice, taskSlice
– UI modals, task lists, board cards, notifications
- API Layer (Server-side in Next.js)
– src/app/api/auth/login/route.ts
– src/app/api/auth/register/route.ts
– src/app/api/boards/route.ts and nested board/task routes
- Data Store
– In-memory JSON defined in src/lib/data.ts
- Auth Mechanism
– bcryptjs for hashing passwords
– JWT tokens issued at login/register
– Protected routes checking JWT
- External/Dev Tools
– ESLint, Tailwind CSS, PostCSS, Next.js config, shell scripts

##### Interactions and Data Flow
1. User opens browser → Next.js renders pages (SSR/CSR)
2. UI dispatches Redux action (e.g., login, fetch boards)
3. Redux middleware calls Next.js API route (/api/auth/login or /api/boards)
4. API route handler validates JWT or credentials, reads/writes src/lib/data.ts
5. Handler returns JSON response (data or error)
6. Redux reducer updates store → UI re-renders

##### Architectural Patterns and Design Principles
- Client-Server separation: UI vs API endpoints
- Single-page-app (SPA) like behavior using Next.js and Redux
- Serverless API functions (each file in src/app/api is an isolated handler)
- Layered design: UI → State → API → Data store
- Protected routes using middleware or hooks

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend (Client)" 
        direction TB
        A1["Next.js App (Pages & Layout)"]:::frontend
        A2["Global Styles"]:::frontend
        A3["Root Layout"]:::frontend
        A4["Home Page"]:::frontend
        A5["Login Page"]:::frontend
        A6["Register Page"]:::frontend
        A7["Dashboard Page"]:::frontend
        A8["Board Detail Page"]:::frontend
        A9["React Components (UI Modals, Cards, Lists, Notifications)"]:::frontend
        A10["Redux Toolkit Store"]:::store
    end

    %% API Layer
    subgraph "API Layer (Serverless Functions)"
        direction TB
        B1["API Route: /api/auth/login"]:::api
        B2["API Route: /api/auth/register"]:::api
        B3["API Route: /api/boards"]:::api
        B4["API Route: /api/boards/[id]"]:::api
        B5["API Route: /api/boards/[id]/tasks"]:::api
        B6["API Route: /api/boards/[id]/tasks/[taskId]"]:::api
    end

    %% Data Store
    subgraph "Data Store"
        direction TB
        C1["In-Memory JSON Data"]:::data
    end

    %% Auth Subsystem
    subgraph "Auth Mechanism"
        direction TB
        D1["bcryptjs (Password Hashing)"]:::auth
        D2["JWT Token Service"]:::auth
    end

    %% Dev Tools
    subgraph "Configuration & Dev Tools"
        direction TB
        E1["Next.js Config"]:::dev
        E2["Tailwind/PostCSS Config"]:::dev
        E3["ESLint Config"]:::dev
        E4["Shell Scripts (setup.sh, start.sh)"]:::dev
    end

    %% Connections - User Flow
    U["User Browser"]:::external -->|"requests SSR/CSR"| A1
    A1 -->|"renders UI"| U

    %% UI to Redux to API
    A9 -->|"dispatch action"| A10
    A10 -->|"dispatch middleware"| B1
    A10 -->|"dispatch middleware"| B2
    A10 -->|"dispatch middleware"| B3
    A10 -->|"dispatch middleware"| B4
    A10 -->|"dispatch middleware"| B5
    A10 -->|"dispatch middleware"| B6

    %% API to Data Store
    B1 -->|"validate/read/write"| C1
    B2 -->|"validate/read/write"| C1
    B3 -->|"read/write"| C1
    B4 -->|"read/write"| C1
    B5 -->|"read/write"| C1
    B6 -->|"read/write"| C1

    %% Auth flows
    B1 -->|"hash/compare"| D1
    B2 -->|"hash/compare"| D1
    B1 -->|"issue token"| D2
    B2 -->|"issue token"| D2
    D2 -->|"attach token"| A10

    %% Data back to UI
    C1 -->|"response JSON"| B1
    B1 -->|"response"| A10
    C1 -->|"response JSON"| B2
    B2 -->|"response"| A10
    C1 -->|"response JSON"| B3
    B3 -->|"response"| A10
    C1 -->|"response JSON"| B4
    B4 -->|"response"| A10
    C1 -->|"response JSON"| B5
    B5 -->|"response"| A10
    C1 -->|"response JSON"| B6
    B6 -->|"response"| A10
    A10 -->|"update store"| A9

    %% Dev Tools edges
    E1 --> A1
    E2 --> A1
    E3 --> A1
    E4 --> A1
    E4 --> B1

    %% Click Events - Frontend
    click A1 "https://github.com/1711shashank/taskboards-app/tree/master/src/app"
    click A2 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/globals.css"
    click A3 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/layout.tsx"
    click A4 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/page.tsx"
    click A5 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/auth/login/page.tsx"
    click A6 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/auth/register/page.tsx"
    click A7 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/dashboard/page.tsx"
    click A8 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/board/[id]/page.tsx"
    click A9 "https://github.com/1711shashank/taskboards-app/tree/master/src/components"
    click A10 "https://github.com/1711shashank/taskboards-app/blob/master/src/store/store.ts"
    click A10 "https://github.com/1711shashank/taskboards-app/blob/master/src/store/provider.tsx"
    click A10 "https://github.com/1711shashank/taskboards-app/blob/master/src/store/hooks.ts"
    click A10 "https://github.com/1711shashank/taskboards-app/blob/master/src/store/slices/authSlice.ts"
    click A10 "https://github.com/1711shashank/taskboards-app/blob/master/src/store/slices/boardSlice.ts"
    click A10 "https://github.com/1711shashank/taskboards-app/blob/master/src/store/slices/taskSlice.ts"

    %% Click Events - Data Store
    click C1 "https://github.com/1711shashank/taskboards-app/blob/master/src/lib/data.ts"

    %% Click Events - API Layer
    click B1 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/api/auth/login/route.ts"
    click B2 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/api/auth/register/route.ts"
    click B3 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/api/boards/route.ts"
    click B4 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/api/boards/[id]/route.ts"
    click B5 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/api/boards/[id]/tasks/route.ts"
    click B6 "https://github.com/1711shashank/taskboards-app/blob/master/src/app/api/boards/[id]/tasks/[taskId]/route.ts"

    %% Click Events - Dev Tools
    click E1 "https://github.com/1711shashank/taskboards-app/blob/master/next.config.js"
    click E2 "https://github.com/1711shashank/taskboards-app/blob/master/tailwind.config.js"
    click E2 "https://github.com/1711shashank/taskboards-app/blob/master/postcss.config.js"
    click E3 "https://github.com/1711shashank/taskboards-app/blob/master/eslint.config.mjs"
    click E4 "https://github.com/1711shashank/taskboards-app/blob/master/setup.sh"
    click E4 "https://github.com/1711shashank/taskboards-app/blob/master/start.sh"

    %% Styles
    classDef frontend fill:#D6E9FF,stroke:#2B6CB0,color:#2B6CB0
    classDef api fill:#DFFFE0,stroke:#2F855A,color:#2F855A
    classDef data fill:#FFF4E6,stroke:#DD6B20,color:#DD6B20
    classDef auth fill:#F3E8FF,stroke:#6B46C1,color:#6B46C1
    classDef store fill:#E6FFFA,stroke:#2C7A7B,color:#2C7A7B
    classDef dev fill:#EDF2F7,stroke:#4A5568,color:#4A5568
    classDef external fill:#FFFFFF,stroke:#718096,color:#718096
```
