# souravo2/nirmoho-news-website architecture

> Architecture diagram of the GitHub repository souravo2/nirmoho-news-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/souravo2/nirmoho-news-website
- Repository: https://github.com/souravo2/nirmoho-news-website

## Overview

NirMoho is a Bengali news-reading website. Readers land on a section-based homepage, browse category listings, and follow article links; the homepage, category page, and breaking-news marquee fetch data from the documented news API. Article detail pages render article content, though their data-fetch implementation was not excerpted. The graph also preserves the shared site shell, navigation, footer, and supporting UI components. Edges reflect shown calls, imports, or fetches; unsampled behavior and integrations are not inferred.

Main entry points: [`src/app/page.tsx`](https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/page.tsx) (Homepage), [`src/components/Navbar/Navbar.tsx`](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/Navbar.tsx) (Navbar), [`src/types/NewsProp.ts`](https://github.com/souravo2/nirmoho-news-website/blob/master/src/types/NewsProp.ts) (News contract), [`src/app/category/[categoryId]/page.tsx`](https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/category/%5BcategoryId%5D/page.tsx) (Category listing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routes["Pages and discovery"]
  node_home["Homepage<br/>[page.tsx]"]
  node_category["Category listing<br/>[page.tsx]"]
  node_article["Article page<br/>[page.tsx]"]
end

subgraph group_shell["Shared site shell"]
  node_layout["Application layout<br/>[layout.tsx]"]
  node_navbar["Navbar<br/>[Navbar.tsx]"]
  node_navlinks["Navigation links<br/>[Navlinks.tsx]"]
  node_navitems["Navigation items<br/>[NavItems.tsx]"]
  node_time["Clock display<br/>[Time.tsx]"]
  node_date["Date display<br/>[DateDisplay.tsx]"]
  node_marquee["Breaking-news ticker<br/>[Marquee.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_back_to_top["Back to top<br/>[BackToTop.tsx]"]
end

subgraph group_display["News presentation"]
  node_main_news["Lead news<br/>[MainNews.tsx]"]
  node_most_read["Most read<br/>[MostRead.tsx]"]
  node_card["News card<br/>[Card.tsx]"]
  node_article_card["Article content<br/>[ArticleCard.tsx]"]
end

subgraph group_contracts["Data contracts"]
  node_article_type["Article contract<br/>[ArticleType.ts]"]
  node_marquee_type["Ticker contract<br/>[MarqueeProp.ts]"]
  node_news_type["News contract<br/>[NewsProp.ts]"]
  node_section_type["Section contract"]
end

node_reader(("News reader"))
node_news_api{{"News API"}}

node_reader -->|"opens"| node_home
node_reader -->|"browses"| node_category
node_reader -->|"reads"| node_article
node_home -->|"fetches sections"| node_news_api
node_category -->|"fetches category"| node_news_api
node_marquee -->|"fetches headlines"| node_news_api
node_layout -->|"renders"| node_navbar
node_layout -->|"renders"| node_footer
node_layout -->|"renders"| node_back_to_top
node_navbar -->|"renders"| node_navlinks
node_navbar -->|"renders"| node_time
node_navbar -->|"renders"| node_date
node_navbar -->|"renders"| node_marquee
node_navlinks -->|"uses"| node_navitems
node_home -->|"renders"| node_main_news
node_home -->|"renders"| node_most_read
node_home -->|"renders"| node_card
node_category -->|"renders"| node_card
node_article -->|"renders"| node_article_card
node_marquee -->|"types data"| node_marquee_type
node_home -->|"types data"| node_news_type
node_category -->|"types data"| node_news_type
node_main_news -->|"types input"| node_news_type
node_card -->|"types input"| node_news_type
node_most_read -->|"types input"| node_news_type
node_home -->|"types sections"| node_section_type
node_navitems -->|"types items"| node_article_type

click node_home "https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/page.tsx"
click node_category "https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/category/%5BcategoryId%5D/page.tsx"
click node_article "https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/article/%5BarticleId%5D/page.tsx"
click node_layout "https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/layout.tsx"
click node_navbar "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/Navbar.tsx"
click node_navlinks "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/Navlinks.tsx"
click node_navitems "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/NavItems.tsx"
click node_time "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/Time.tsx"
click node_date "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/DateDisplay.tsx"
click node_marquee "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/Marquee.tsx"
click node_footer "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Footer.tsx"
click node_back_to_top "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/shared/BackToTop.tsx"
click node_main_news "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/homepage/MainNews.tsx"
click node_most_read "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/homepage/MostRead.tsx"
click node_card "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/shared/Card.tsx"
click node_article_card "https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/shared/ArticleCard.tsx"
click node_article_type "https://github.com/souravo2/nirmoho-news-website/blob/master/src/types/ArticleType.ts"
click node_marquee_type "https://github.com/souravo2/nirmoho-news-website/blob/master/src/types/MarqueeProp.ts"
click node_news_type "https://github.com/souravo2/nirmoho-news-website/blob/master/src/types/NewsProp.ts"
click node_section_type "https://github.com/souravo2/nirmoho-news-website/blob/master/src/types/WholeSectionType.ts"

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_home,node_category,node_article toneBlue
class node_layout,node_navbar,node_navlinks,node_navitems,node_time,node_date,node_marquee,node_footer,node_back_to_top toneAmber
class node_main_news,node_most_read,node_card,node_article_card,node_news_api toneMint
class node_article_type,node_marquee_type,node_news_type,node_section_type toneRose
class node_reader toneIndigo
```

## Components

### Pages and discovery

- [Homepage](https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/page.tsx): `src/app/page.tsx`
- [Category listing](https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/category/%5BcategoryId%5D/page.tsx): `src/app/category/[categoryId]/page.tsx`
- [Article page](https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/article/%5BarticleId%5D/page.tsx): `src/app/article/[articleId]/page.tsx`

### Shared site shell

- [Application layout](https://github.com/souravo2/nirmoho-news-website/blob/master/src/app/layout.tsx): `src/app/layout.tsx`
- [Navbar](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/Navbar.tsx): `src/components/Navbar/Navbar.tsx`
- [Navigation links](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/Navlinks.tsx): `src/components/Navbar/Navlinks.tsx`
- [Navigation items](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/NavItems.tsx): `src/components/Navbar/NavItems.tsx`
- [Clock display](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/Time.tsx): `src/components/Navbar/Time.tsx`
- [Date display](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/DateDisplay.tsx): `src/components/Navbar/DateDisplay.tsx`
- [Breaking-news ticker](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Navbar/Marquee.tsx): `src/components/Navbar/Marquee.tsx`
- [Footer](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/Footer.tsx): `src/components/Footer.tsx`
- [Back to top](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/shared/BackToTop.tsx): `src/components/shared/BackToTop.tsx`

### News presentation

- [Lead news](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/homepage/MainNews.tsx): `src/components/homepage/MainNews.tsx`
- [Most read](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/homepage/MostRead.tsx): `src/components/homepage/MostRead.tsx`
- [News card](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/shared/Card.tsx): `src/components/shared/Card.tsx`
- [Article content](https://github.com/souravo2/nirmoho-news-website/blob/master/src/components/shared/ArticleCard.tsx): `src/components/shared/ArticleCard.tsx`

### Data contracts

- [Article contract](https://github.com/souravo2/nirmoho-news-website/blob/master/src/types/ArticleType.ts): `src/types/ArticleType.ts`
- [Ticker contract](https://github.com/souravo2/nirmoho-news-website/blob/master/src/types/MarqueeProp.ts): `src/types/MarqueeProp.ts`
- [News contract](https://github.com/souravo2/nirmoho-news-website/blob/master/src/types/NewsProp.ts): `src/types/NewsProp.ts`
- [Section contract](https://github.com/souravo2/nirmoho-news-website/blob/master/src/types/WholeSectionType.ts): `src/types/WholeSectionType.ts`

### Other components

- **News reader**
- **News API**

## Connections

- News reader → Homepage: opens (evidence: `src/app/page.tsx`)
- News reader → Category listing: browses (evidence: `src/app/category/[categoryId]/page.tsx`)
- News reader → Article page: reads (evidence: `src/app/article/[articleId]/page.tsx`)
- Homepage → News API: fetches sections (evidence: `src/app/page.tsx`)
- Category listing → News API: fetches category (evidence: `src/app/category/[categoryId]/page.tsx`)
- Breaking-news ticker → News API: fetches headlines (evidence: `src/components/Navbar/Marquee.tsx`)
- Application layout → Navbar: renders (evidence: `src/app/layout.tsx`)
- Application layout → Footer: renders (evidence: `src/app/layout.tsx`)
- Application layout → Back to top: renders (evidence: `src/app/layout.tsx`)
- Navbar → Navigation links: renders (evidence: `src/components/Navbar/Navbar.tsx`)
- Navbar → Clock display: renders (evidence: `src/components/Navbar/Navbar.tsx`)
- Navbar → Date display: renders (evidence: `src/components/Navbar/Navbar.tsx`)
- Navbar → Breaking-news ticker: renders (evidence: `src/components/Navbar/Navbar.tsx`)
- Navigation links → Navigation items: uses (evidence: `src/components/Navbar/Navlinks.tsx`)
- Homepage → Lead news: renders (evidence: `src/app/page.tsx`)
- Homepage → Most read: renders (evidence: `src/app/page.tsx`)
- Homepage → News card: renders (evidence: `src/app/page.tsx`)
- Category listing → News card: renders (evidence: `src/app/category/[categoryId]/page.tsx`)
- Article page → Article content: renders (evidence: `src/app/article/[articleId]/page.tsx`)
- Breaking-news ticker → Ticker contract: types data (evidence: `src/components/Navbar/Marquee.tsx`)
- Homepage → News contract: types data (evidence: `src/app/page.tsx`)
- Category listing → News contract: types data (evidence: `src/app/category/[categoryId]/page.tsx`)
- Lead news → News contract: types input (evidence: `src/components/homepage/MainNews.tsx`)
- News card → News contract: types input (evidence: `src/components/shared/Card.tsx`)
- Most read → News contract: types input (evidence: `src/components/homepage/MostRead.tsx`)
- Homepage → Section contract: types sections (evidence: `src/app/page.tsx`)
- Navigation items → Article contract: types items (evidence: `src/components/Navbar/NavItems.tsx`)
