# pisethmao/nexpress architecture

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

- Interactive diagram: https://gitdiagram.com/pisethmao/nexpress
- Repository: https://github.com/pisethmao/nexpress

## Overview

NexPress is a Next.js blogging and content-discovery frontend. Visitors enter through the home page, browse featured, categorized, latest, and feed content, and can explore author/about and category pages; the newsletter form records a subscription locally in the browser. The graph also retains the blog and authentication routes. Relationships are limited to route composition and data dependencies visible in excerpts or the SOURCE INDEX; unsampled implementation details are not inferred.

Main entry points: [`src/app/page.tsx`](https://github.com/pisethmao/nexpress/blob/master/src/app/page.tsx) (Home page), [`src/components/FooterSection.tsx`](https://github.com/pisethmao/nexpress/blob/master/src/components/FooterSection.tsx) (Footer), [`src/components/navbar/Navbar.tsx`](https://github.com/pisethmao/nexpress/blob/master/src/components/navbar/Navbar.tsx) (Navigation), [`src/app/categories/page.tsx`](https://github.com/pisethmao/nexpress/blob/master/src/app/categories/page.tsx) (Categories route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routes["Routes and shell"]
  node_home["Home page<br/>[page.tsx]"]
  node_layout["App layout<br/>[layout.tsx]"]
  node_aboutpage["About route<br/>[page.tsx]"]
  node_blogspage["Blogs route<br/>[page.tsx]"]
  node_categoriespage["Categories route<br/>[page.tsx]"]
  node_authroutes["Login and register"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_theme["Theme toggle<br/>[ThemeToggle.tsx]"]
  node_footer["Footer<br/>[FooterSection.tsx]"]
end

subgraph group_discovery["Content discovery"]
  node_hero["Hero section<br/>[HeroSection.tsx]"]
  node_featured["Featured posts<br/>[FeaturedPosts.tsx]"]
  node_categories["Category section"]
  node_latest["Latest posts"]
  node_feed["Blog feed<br/>[BlogFeed.tsx]"]
  node_postcards["Post cards<br/>[BlogCard.tsx]"]
  node_blog["Blog experience<br/>[Blog.tsx]"]
end

subgraph group_engagement["Reader engagement"]
  node_author["Author spotlight"]
  node_about["About and team<br/>[About.tsx]"]
  node_newsletter["Newsletter form"]
end

subgraph group_contentdata["Content data"]
  node_footerdata["Footer content<br/>[footerData.ts]"]
  node_teamdata["Team content<br/>[teamData.ts]"]
  node_featureddata["Featured content"]
  node_author_data["Author content<br/>[authorData.ts]"]
  node_blogfeeddata["Feed content<br/>[blogFeedData.ts]"]
  node_latestdata["Latest content<br/>[latestPostData.ts]"]
  node_navdata["Navigation content<br/>[navItemData.ts]"]
  node_newsletterdata["Newsletter copy<br/>[newsletterData.ts]"]
  node_hero_data["Hero content<br/>[heroData.ts]"]
  node_categorydata["Category content<br/>[categoryData.ts]"]
end

node_visitor(("Visitor"))
node_browserstorage[("Browser local storage")]
node_postapi["Posts API"]

node_visitor -->|"opens"| node_home
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_featured
node_home -->|"renders"| node_categories
node_home -->|"renders"| node_latest
node_home -->|"renders"| node_author
node_home -->|"renders"| node_newsletter
node_home -->|"renders"| node_feed
node_home -->|"renders"| node_footer
node_layout -->|"includes"| node_navbar
node_layout -->|"includes"| node_footer
node_navbar -->|"renders"| node_theme
node_aboutpage -->|"renders"| node_about
node_aboutpage -->|"renders"| node_footer
node_blogspage -->|"renders"| node_blog
node_categoriespage -->|"renders"| node_postcards
node_categoriespage -->|"renders"| node_navbar
node_categoriespage -->|"renders"| node_footer
node_footer -->|"reads"| node_footerdata
node_about -->|"reads"| node_teamdata
node_featured -->|"reads"| node_featureddata
node_author -->|"reads"| node_author_data
node_feed -->|"reads"| node_blogfeeddata
node_latest -->|"reads"| node_latestdata
node_navbar -->|"reads"| node_navdata
node_newsletter -->|"reads"| node_newsletterdata
node_hero -.->|"reads"| node_hero_data
node_categories -->|"reads"| node_categorydata
node_postcards -->|"fetches posts"| node_postapi
node_newsletter -->|"stores email"| node_browserstorage

click node_home "https://github.com/pisethmao/nexpress/blob/master/src/app/page.tsx"
click node_layout "https://github.com/pisethmao/nexpress/blob/master/src/app/layout.tsx"
click node_aboutpage "https://github.com/pisethmao/nexpress/blob/master/src/app/about/page.tsx"
click node_blogspage "https://github.com/pisethmao/nexpress/blob/master/src/app/blogs/page.tsx"
click node_categoriespage "https://github.com/pisethmao/nexpress/blob/master/src/app/categories/page.tsx"
click node_authroutes "https://github.com/pisethmao/nexpress/tree/master/src/app/(auth)"
click node_hero "https://github.com/pisethmao/nexpress/blob/master/src/components/hero/HeroSection.tsx"
click node_featured "https://github.com/pisethmao/nexpress/blob/master/src/components/featured/FeaturedPosts.tsx"
click node_categories "https://github.com/pisethmao/nexpress/blob/master/src/components/categories/CategoriesSection.tsx"
click node_latest "https://github.com/pisethmao/nexpress/blob/master/src/components/latest/LatestPostsSection.tsx"
click node_feed "https://github.com/pisethmao/nexpress/blob/master/src/components/BlogFeed.tsx"
click node_postcards "https://github.com/pisethmao/nexpress/blob/master/src/components/cards/BlogCard.tsx"
click node_blog "https://github.com/pisethmao/nexpress/blob/master/src/components/blog/Blog.tsx"
click node_author "https://github.com/pisethmao/nexpress/blob/master/src/components/author/AuthorSpotlight.tsx"
click node_about "https://github.com/pisethmao/nexpress/blob/master/src/components/about/About.tsx"
click node_newsletter "https://github.com/pisethmao/nexpress/blob/master/src/components/newsletter/NewsletterSection.tsx"
click node_navbar "https://github.com/pisethmao/nexpress/blob/master/src/components/navbar/Navbar.tsx"
click node_theme "https://github.com/pisethmao/nexpress/blob/master/src/components/theme/ThemeToggle.tsx"
click node_footer "https://github.com/pisethmao/nexpress/blob/master/src/components/FooterSection.tsx"
click node_footerdata "https://github.com/pisethmao/nexpress/blob/master/src/Data/footerData.ts"
click node_teamdata "https://github.com/pisethmao/nexpress/blob/master/src/Data/teamData.ts"
click node_featureddata "https://github.com/pisethmao/nexpress/blob/master/src/Data/featuredPostsData.ts"
click node_author_data "https://github.com/pisethmao/nexpress/blob/master/src/Data/authorData.ts"
click node_blogfeeddata "https://github.com/pisethmao/nexpress/blob/master/src/Data/blogFeedData.ts"
click node_latestdata "https://github.com/pisethmao/nexpress/blob/master/src/Data/latestPostData.ts"
click node_navdata "https://github.com/pisethmao/nexpress/blob/master/src/Data/navItemData.ts"
click node_newsletterdata "https://github.com/pisethmao/nexpress/blob/master/src/Data/newsletterData.ts"
click node_hero_data "https://github.com/pisethmao/nexpress/blob/master/src/Data/heroData.ts"
click node_categorydata "https://github.com/pisethmao/nexpress/blob/master/src/Data/categoryData.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_layout,node_aboutpage,node_blogspage,node_categoriespage,node_authroutes,node_navbar,node_theme,node_footer toneBlue
class node_hero,node_featured,node_categories,node_latest,node_feed,node_postcards,node_blog,node_browserstorage toneAmber
class node_author,node_about,node_newsletter,node_postapi toneMint
class node_footerdata,node_teamdata,node_featureddata,node_author_data,node_blogfeeddata,node_latestdata,node_navdata,node_newsletterdata,node_hero_data,node_categorydata toneRose
class node_visitor toneIndigo
```

## Components

### Routes and shell

- [Home page](https://github.com/pisethmao/nexpress/blob/master/src/app/page.tsx): `src/app/page.tsx`
- [App layout](https://github.com/pisethmao/nexpress/blob/master/src/app/layout.tsx): `src/app/layout.tsx`
- [About route](https://github.com/pisethmao/nexpress/blob/master/src/app/about/page.tsx): `src/app/about/page.tsx`
- [Blogs route](https://github.com/pisethmao/nexpress/blob/master/src/app/blogs/page.tsx): `src/app/blogs/page.tsx`
- [Categories route](https://github.com/pisethmao/nexpress/blob/master/src/app/categories/page.tsx): `src/app/categories/page.tsx`
- [Login and register](https://github.com/pisethmao/nexpress/tree/master/src/app/(auth)): `src/app/(auth)`
- [Navigation](https://github.com/pisethmao/nexpress/blob/master/src/components/navbar/Navbar.tsx): `src/components/navbar/Navbar.tsx`
- [Theme toggle](https://github.com/pisethmao/nexpress/blob/master/src/components/theme/ThemeToggle.tsx): `src/components/theme/ThemeToggle.tsx`
- [Footer](https://github.com/pisethmao/nexpress/blob/master/src/components/FooterSection.tsx): `src/components/FooterSection.tsx`

### Content discovery

- [Hero section](https://github.com/pisethmao/nexpress/blob/master/src/components/hero/HeroSection.tsx): `src/components/hero/HeroSection.tsx`
- [Featured posts](https://github.com/pisethmao/nexpress/blob/master/src/components/featured/FeaturedPosts.tsx): `src/components/featured/FeaturedPosts.tsx`
- [Category section](https://github.com/pisethmao/nexpress/blob/master/src/components/categories/CategoriesSection.tsx): `src/components/categories/CategoriesSection.tsx`
- [Latest posts](https://github.com/pisethmao/nexpress/blob/master/src/components/latest/LatestPostsSection.tsx): `src/components/latest/LatestPostsSection.tsx`
- [Blog feed](https://github.com/pisethmao/nexpress/blob/master/src/components/BlogFeed.tsx): `src/components/BlogFeed.tsx`
- [Post cards](https://github.com/pisethmao/nexpress/blob/master/src/components/cards/BlogCard.tsx): `src/components/cards/BlogCard.tsx`
- [Blog experience](https://github.com/pisethmao/nexpress/blob/master/src/components/blog/Blog.tsx): `src/components/blog/Blog.tsx`

### Reader engagement

- [Author spotlight](https://github.com/pisethmao/nexpress/blob/master/src/components/author/AuthorSpotlight.tsx): `src/components/author/AuthorSpotlight.tsx`
- [About and team](https://github.com/pisethmao/nexpress/blob/master/src/components/about/About.tsx): `src/components/about/About.tsx`
- [Newsletter form](https://github.com/pisethmao/nexpress/blob/master/src/components/newsletter/NewsletterSection.tsx): `src/components/newsletter/NewsletterSection.tsx`

### Content data

- [Footer content](https://github.com/pisethmao/nexpress/blob/master/src/Data/footerData.ts): `src/Data/footerData.ts`
- [Team content](https://github.com/pisethmao/nexpress/blob/master/src/Data/teamData.ts): `src/Data/teamData.ts`
- [Featured content](https://github.com/pisethmao/nexpress/blob/master/src/Data/featuredPostsData.ts): `src/Data/featuredPostsData.ts`
- [Author content](https://github.com/pisethmao/nexpress/blob/master/src/Data/authorData.ts): `src/Data/authorData.ts`
- [Feed content](https://github.com/pisethmao/nexpress/blob/master/src/Data/blogFeedData.ts): `src/Data/blogFeedData.ts`
- [Latest content](https://github.com/pisethmao/nexpress/blob/master/src/Data/latestPostData.ts): `src/Data/latestPostData.ts`
- [Navigation content](https://github.com/pisethmao/nexpress/blob/master/src/Data/navItemData.ts): `src/Data/navItemData.ts`
- [Newsletter copy](https://github.com/pisethmao/nexpress/blob/master/src/Data/newsletterData.ts): `src/Data/newsletterData.ts`
- [Hero content](https://github.com/pisethmao/nexpress/blob/master/src/Data/heroData.ts): `src/Data/heroData.ts`
- [Category content](https://github.com/pisethmao/nexpress/blob/master/src/Data/categoryData.ts): `src/Data/categoryData.ts`

### Other components

- **Visitor**
- **Browser local storage**
- **Posts API**

## Connections

- Visitor → Home page: opens
- Home page → Hero section: renders (evidence: `src/app/page.tsx`)
- Home page → Featured posts: renders (evidence: `src/app/page.tsx`)
- Home page → Category section: renders (evidence: `src/app/page.tsx`)
- Home page → Latest posts: renders (evidence: `src/app/page.tsx`)
- Home page → Author spotlight: renders (evidence: `src/app/page.tsx`)
- Home page → Newsletter form: renders (evidence: `src/app/page.tsx`)
- Home page → Blog feed: renders (evidence: `src/app/page.tsx`)
- Home page → Footer: renders (evidence: `src/app/page.tsx`)
- App layout → Navigation: includes (evidence: `src/app/layout.tsx`)
- App layout → Footer: includes (evidence: `src/app/layout.tsx`)
- Navigation → Theme toggle: renders (evidence: `src/components/navbar/Navbar.tsx`)
- About route → About and team: renders (evidence: `src/app/about/page.tsx`)
- About route → Footer: renders (evidence: `src/app/about/page.tsx`)
- Blogs route → Blog experience: renders (evidence: `src/app/blogs/page.tsx`)
- Categories route → Post cards: renders (evidence: `src/app/categories/page.tsx`)
- Categories route → Navigation: renders (evidence: `src/app/categories/page.tsx`)
- Categories route → Footer: renders (evidence: `src/app/categories/page.tsx`)
- Footer → Footer content: reads (evidence: `src/components/FooterSection.tsx`)
- About and team → Team content: reads (evidence: `src/components/about/About.tsx`)
- Featured posts → Featured content: reads (evidence: `src/components/featured/FeaturedPosts.tsx`)
- Author spotlight → Author content: reads (evidence: `src/components/author/AuthorSpotlight.tsx`)
- Blog feed → Feed content: reads (evidence: `src/components/BlogFeed.tsx`)
- Latest posts → Latest content: reads (evidence: `src/components/latest/LatestPostsSection.tsx`)
- Navigation → Navigation content: reads (evidence: `src/components/navbar/Navbar.tsx`)
- Newsletter form → Newsletter copy: reads (evidence: `src/components/newsletter/NewsletterSection.tsx`)
- Hero section → Hero content: reads (evidence: `src/components/hero/HeroSection.tsx`)
- Category section → Category content: reads (evidence: `src/components/categories/CategoriesSection.tsx`)
- Post cards → Posts API: fetches posts (evidence: `src/components/cards/BlogCard.tsx`)
- Newsletter form → Browser local storage: stores email (evidence: `src/components/newsletter/NewsletterSection.tsx`)
