# pankaj116-andc/nexusboard architecture

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

- Interactive diagram: https://gitdiagram.com/pankaj116-andc/nexusboard
- Repository: https://github.com/pankaj116-andc/nexusboard

## Overview

1. **What this repo is**
   - `NexusBoard` is an **Angular 18 single-page client application**. The architecture is UI-first and browser-run; there is no visible backend, API client, or database layer in the repo.

2. **App bootstrap and shell**
   - `src/main.ts`, `app.config.ts`, and `app.routes.ts` define the Angular startup path.
   - `app.component.*` is the top-level shell that likely hosts routing and the main layout.
   - This suggests a **standalone Angular app structure** rather than a classic NgModule-based one.

3. **Primary feature boundary: Kanban**
   - Most of the application lives under `src/app/features/kanban`.
   - The feature is decomposed into focused UI components for a **Kanban board domain**: board, columns, task cards, task modal, and activity log.
   - This is the main architectural boundary for the app.

4. **State ownership**
   - `src/app/core/services/board-state.service.ts` is the central state holder for the board.
   - The naming implies **shared in-memory application state** for columns, tasks, selection/editing state, and activity history.
   - UI components likely interact with this service rather than talking directly to each other.

5. **Domain model layer**
   - `src/app/core/models/board.models.ts` defines the board/task data shapes.
   - This is the app’s domain contract boundary: components and services should depend on these models instead of ad hoc objects.

6. **Board rendering pipeline**
   - `board.component.ts` is the container for the Kanban experience.
   - `column.component.ts` likely renders each lane/column.
   - `task-card.component.ts` renders individual tasks inside a column.
   - The likely data flow is: **board state service → board component → column components → task card components**.

7. **Task interaction and editing**
   - `task-modal.component.ts` is the edit/create/detail surface for a task.
   - This indicates a split between **read/display components** (board, columns, cards) and a **focused interaction component** for task mutation.
   - The modal probably reads from and writes back to the shared board-state service.

8. **Activity/history tracking**
   - `activity-log.component.ts` is a separate presentation surface for task/board events.
   - Architecturally, this implies the board state service likely records actions and exposes them to the log component.
   - This is useful for diagramming a secondary data stream: **user actions → state service → activity log UI**.

9. **Shared presentation logic**
   - `src/app/shared/directives/priority-glow.directive.ts` is a reusable behavioral/presentation directive.
   - `src/app/shared/pipes/days-until-due.pipe.ts` is a reusable transformation for due-date display.
   - These are cross-cutting UI helpers, kept out of the feature components so the feature remains focused on Kanban behavior.

10. **Styling and UI system**
   - `tailwind.config.js`, `src/styles.css`, and component CSS files indicate a mix of **global styling plus component-scoped styles**, with Tailwind in the stack.
   - The visual architecture is therefore component-driven, with utility styling layered on top.

11. **Project boundaries**
   - `src/app/core` contains app-wide primitives: models and services.
   - `src/app/features` contains business functionality.
   - `src/app/shared` contains reusable UI behavior.
   - This is a clean separation that should appear in the architecture diagram as **core / feature / shared** layers.

12. **What is not present**
   - There is no visible persistence layer, REST client, authentication subsystem, or server integration.
   - For architecture purposes, treat board data as **local client state** managed inside Angular, with components synchronized through the service.

13. **Tooling/runtime**
   - Angular CLI is the build and dev runtime (`ng serve`, `ng build`, `ng test`).
   - The app targets the browser and uses Angular’s standard tooling plus Karma for tests.

Main entry points: [`src/styles.css`](https://github.com/pankaj116-andc/nexusboard/blob/main/src/styles.css) (Global styles), [`src/app/features/kanban/components/task-card/task-card.component.ts`](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/task-card/task-card.component.ts) (Task card), [`src/app/features/kanban/components/board/board.component.ts`](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/board/board.component.ts) (Board view), [`src/app/core/services/board-state.service.ts`](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/core/services/board-state.service.ts) (Board state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_main["main.ts<br/>bootstrap<br/>[main.ts]"]
  node_config["app.config<br/>bootstrap config<br/>[app.config.ts]"]
  node_routes["app.routes<br/>route map<br/>[app.routes.ts]"]
  node_app["App shell<br/>root component<br/>[app.component.ts]"]
  node_styles["Global styles<br/>ui styling<br/>[styles.css]"]
end

subgraph group_core["Core"]
  node_models["Board models<br/>domain model<br/>[board.models.ts]"]
  node_state[("Board state<br/>state service")]
end

subgraph group_kanban["Kanban feature"]
  node_board["Board view<br/>feature container<br/>[board.component.ts]"]
  node_column["Column view<br/>lane component"]
  node_card["Task card<br/>task item"]
  node_modal["Task modal<br/>task editor"]
  node_activity["Activity log<br/>event view"]
end

subgraph group_shared["Shared UI"]
  node_glow{{"Priority glow<br/>directive"}}
  node_days{{"Due date pipe"}}
end

node_main -->|"initializes"| node_config
node_main -->|"mounts"| node_app
node_config -->|"uses"| node_routes
node_app -->|"navigates"| node_routes
node_board -->|"reads/writes"| node_state
node_board -->|"uses"| node_models
node_column -->|"nested in"| node_board
node_card -->|"nested in"| node_column
node_modal -->|"mutates"| node_state
node_activity -->|"subscribes"| node_state
node_state -->|"stores"| node_models
node_card -->|"decorates"| node_glow
node_card -->|"formats"| node_days
node_board -.->|"styled by"| node_styles
node_column -.->|"styled by"| node_styles
node_card -.->|"styled by"| node_styles
node_modal -.->|"styled by"| node_styles
node_activity -.->|"styled by"| node_styles

click node_main "https://github.com/pankaj116-andc/nexusboard/blob/main/src/main.ts"
click node_config "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/app.config.ts"
click node_routes "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/app.routes.ts"
click node_app "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/app.component.ts"
click node_models "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/core/models/board.models.ts"
click node_state "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/core/services/board-state.service.ts"
click node_board "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/board/board.component.ts"
click node_column "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/column/column.component.ts"
click node_card "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/task-card/task-card.component.ts"
click node_modal "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/task-modal/task-modal.component.ts"
click node_activity "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/activity-log/activity-log.component.ts"
click node_glow "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/shared/directives/priority-glow.directive.ts"
click node_days "https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/shared/pipes/days-until-due.pipe.ts"
click node_styles "https://github.com/pankaj116-andc/nexusboard/blob/main/src/styles.css"

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_main,node_config,node_routes,node_app,node_styles toneBlue
class node_models,node_state toneAmber
class node_board,node_column,node_card,node_modal,node_activity toneMint
class node_glow,node_days toneRose
```

## Components

### App shell

Angular bootstrap, routing, and top-level layout.

- [main.ts](https://github.com/pankaj116-andc/nexusboard/blob/main/src/main.ts): bootstrap · Angular entrypoint that starts the app. · `src/main.ts`
- [app.config](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/app.config.ts): bootstrap config · Standalone app configuration and providers. · `src/app/app.config.ts`
- [app.routes](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/app.routes.ts): route map · Top-level application routes. · `src/app/app.routes.ts`
- [App shell](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/app.component.ts): root component · Top-level application component and layout host. · `src/app/app.component.ts`
- [Global styles](https://github.com/pankaj116-andc/nexusboard/blob/main/src/styles.css): ui styling · Global styling layer for the application. · `src/styles.css`

### Core

App-wide domain model and shared state.

- [Board models](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/core/models/board.models.ts): domain model · Shared board and task data shapes. · `src/app/core/models/board.models.ts`
- [Board state](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/core/services/board-state.service.ts): state service · Central in-memory board state and activity history. · `src/app/core/services/board-state.service.ts`

### Kanban feature

Primary board experience and task interactions.

- [Board view](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/board/board.component.ts): feature container · Kanban board container and coordinator. · `src/app/features/kanban/components/board/board.component.ts`
- [Column view](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/column/column.component.ts): lane component · Renders a single Kanban column. · `src/app/features/kanban/components/column/column.component.ts`
- [Task card](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/task-card/task-card.component.ts): task item · Displays an individual task within a column. · `src/app/features/kanban/components/task-card/task-card.component.ts`
- [Task modal](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/task-modal/task-modal.component.ts): task editor · Creates, edits, and views task details. · `src/app/features/kanban/components/task-modal/task-modal.component.ts`
- [Activity log](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/features/kanban/components/activity-log/activity-log.component.ts): event view · Shows board and task activity history. · `src/app/features/kanban/components/activity-log/activity-log.component.ts`

### Shared UI

Reusable presentation behavior used across the feature.

- [Priority glow](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/shared/directives/priority-glow.directive.ts): directive · Reusable priority-based visual emphasis. · `src/app/shared/directives/priority-glow.directive.ts`
- [Due date pipe](https://github.com/pankaj116-andc/nexusboard/blob/main/src/app/shared/pipes/days-until-due.pipe.ts): pipe · Formats due-date timing for display. · `src/app/shared/pipes/days-until-due.pipe.ts`

## Connections

- main.ts → app.config: initializes · Bootstraps the Angular application with shared configuration.
- main.ts → App shell: mounts · Starts the root component in the browser.
- app.config → app.routes: uses · Wires application routing into the standalone app setup.
- App shell → app.routes: navigates · Hosts routed views and shell-level layout.
- Board view → Board state: reads/writes · Coordinates board data and task actions through shared state.
- Board view → Board models: uses · Depends on the shared board domain shapes.
- Column view → Board view: nested in · Board composes columns as part of the Kanban layout.
- Task card → Column view: nested in · Columns render task cards.
- Task modal → Board state: mutates · Creates and edits tasks through central state.
- Activity log → Board state: subscribes · Displays activity history produced by board actions.
- Board state → Board models: stores · Keeps board state in the shared domain format.
- Task card → Priority glow: decorates · Uses shared directive for priority emphasis.
- Task card → Due date pipe: formats · Uses shared pipe for due-date display.
- Board view → Global styles: styled by · Relies on global styling plus component styles.
- Column view → Global styles: styled by · Relies on global styling plus component styles.
- Task card → Global styles: styled by · Relies on global styling plus component styles.
- Task modal → Global styles: styled by · Relies on global styling plus component styles.
- Activity log → Global styles: styled by · Relies on global styling plus component styles.
