# salehkhatri/aakaura architecture

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

- Interactive diagram: https://gitdiagram.com/salehkhatri/aakaura
- Repository: https://github.com/salehkhatri/aakaura

## Overview

##### Project type and purpose
- This is a full-stack, content-driven web application built with Next.js (App Router) that serves a public blog and an administrative UI.
- It uses Prisma as an ORM to manage a relational database (e.g., PostgreSQL), Cloudinary for image uploads, and exposes server-side API routes for blog management, authentication, uploads, and sitemap generation.

##### File structure
- Top-level directories:
- prisma – database schema and migrations
- public – static assets (images, robots.txt, sitemap.xml)
- src/app – Next.js App Router:
– page.tsx/layout.tsx at root: public blog pages
– /blogs, /about: public pages
– /admin: protected admin UI pages
– /api: serverless route handlers grouped under /admin and public endpoints (blogs, series, sitemap)
- src/components – React UI components (shared and UI primitives)
- src/config – external service & environment configuration (Prisma client, Cloudinary, fonts, constants)
- src/middleware – request-time logic (auth guard, error handler, JSON parsing)
- src/context – React context (SplashScreen state)
- src/lib, src/utils – helper functions (HTTP wrappers, SEO, uploads, response builders)
- src/types – TypeScript type definitions and Zod schemas
- Config files: next.config.ts, tailwind.config.ts, eslint.config.mjs, tsconfig.json

##### README for additional insights
- Confirms Next.js with built-in font optimization
- Standard npm/pnpm scripts for development & deployment
- Intended to be deployed on Vercel

##### Detail without overthinking
- Layer (UI, server, data) distinctly.
- API groups (public blogs, admin blogs, login, upload, series, sitemap).
- Middleware intercept points for auth and error handling.
- Static asset serving and CDN involvement.
- The goal is to break down the codebase into discrete, labeled components and explicitly map their interactions.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client Layer"
        direction TB
        BrowserPublic["Public Blog Pages"]:::ui
        BrowserAdmin["Admin Dashboard UI"]:::ui
    end

    %% Server Layer
    subgraph "Next.js Server (Vercel Serverless)"
        direction TB
        AppRouter["App Router\n(Server & Client Components)"]:::api
        subgraph "API Routes"
            direction TB
            API_Public_Blogs["/api/blogs/*"]:::api
            API_Public_Featured["/api/blogs/featured"]:::api
            API_Public_ById["/api/blogs/[id]"]:::api
            API_Admin_Blogs["/api/admin/blog/*"]:::api
            API_Admin_ById["/api/admin/blog/[id]"]:::api
            API_Admin_Login["/api/admin/login"]:::api
            API_Admin_Upload["/api/admin/upload"]:::api
            API_Series["/api/series"]:::api
            API_Sitemap["/api/sitemap"]:::api
        end
        Middleware["Middleware\n(auth, errorHandler, parseJson)"]:::api
    end

    %% Data & External Services
    subgraph "Data Layer"
        direction TB
        PrismaClient["Prisma Client"]:::db
        Database["PostgreSQL\n(prisma/schema.prisma)"]:::db
        Cloudinary["Cloudinary\n(image storage)"]:::ext
        CDN["CDN / Static Hosting\n(public/ assets)"]:::ext
    end

    %% Utility & Config
    subgraph "Helpers & Config"
        direction TB
        Config_Prismaclient["src/config/prisma.ts"]:::util
        Config_Cloudinary["src/config/cloudinary.ts"]:::util
        Env_Constants["src/config/env.ts\nsrc/config/constants.ts"]:::util
        Fonts["src/config/fonts.ts"]:::util
        Layout_Styles["src/app/layout.tsx\nsrc/app/globals.css"]:::util
        Shared_Components["src/components/*"]:::util
        Context["src/context/SplashScreenProvider.tsx"]:::util
        Lib_API["src/lib/api.ts"]:::util
        Lib_SEO["src/lib/seo.ts"]:::util
        Utils_Response["src/utils/response.ts"]:::util
        Utils_Upload["src/utils/upload.ts"]:::util
        Types["src/types/*"]:::util
        NextConfig["next.config.ts\ntailwind.config.ts\neslint.config.mjs\ntsconfig.json"]:::util
        Prisma_Migrations["prisma/schema.prisma\nprisma/migrations/"]:::util
    end

    %% Relationships
    BrowserPublic -->|SSR/SSG data fetch| AppRouter
    BrowserAdmin -->|Protected SSR/CSR| AppRouter
    AppRouter -->|calls| Middleware
    Middleware -->|routes to| API_Public_Blogs
    Middleware -->|routes to| API_Public_Featured
    Middleware -->|routes to| API_Public_ById
    Middleware -->|routes to| API_Admin_Blogs
    Middleware -->|routes to| API_Admin_ById
    Middleware -->|routes to| API_Admin_Login
    Middleware -->|routes to| API_Admin_Upload
    Middleware -->|routes to| API_Series
    Middleware -->|routes to| API_Sitemap

    API_Public_Blogs -->|CRUD via Prisma| PrismaClient
    API_Public_Featured -->|CRUD via Prisma| PrismaClient
    API_Public_ById -->|CRUD via Prisma| PrismaClient
    API_Admin_Blogs -->|CRUD via Prisma| PrismaClient
    API_Admin_ById -->|CRUD via Prisma| PrismaClient
    API_Admin_Login -->|Validation via Zod| PrismaClient
    API_Admin_Upload -->|upload image| Cloudinary
    API_Series -->|CRUD via Prisma| PrismaClient
    API_Sitemap -->|generate| PrismaClient

    PrismaClient -->|DB queries| Database
    AppRouter -->|serve static| CDN

    %% Click Events
    click BrowserPublic "https://github.com/salehkhatri/aakaura/blob/main/src/app/page.tsx"
    click BrowserPublic "https://github.com/salehkhatri/aakaura/blob/main/src/app/blogs/page.tsx"
    click BrowserPublic "https://github.com/salehkhatri/aakaura/blob/main/src/app/blogs/[id]/page.tsx"
    click BrowserPublic "https://github.com/salehkhatri/aakaura/blob/main/src/app/about/page.tsx"
    click BrowserAdmin "https://github.com/salehkhatri/aakaura/blob/main/src/app/admin/page.tsx"
    click BrowserAdmin "https://github.com/salehkhatri/aakaura/blob/main/src/app/admin/layout.tsx"
    click BrowserAdmin "https://github.com/salehkhatri/aakaura/blob/main/src/app/admin/blogs/new/page.tsx"
    click BrowserAdmin "https://github.com/salehkhatri/aakaura/blob/main/src/app/admin/blogs/[id]/page.tsx"
    click BrowserAdmin "https://github.com/salehkhatri/aakaura/blob/main/src/app/admin/login/page.tsx"
    click API_Public_Blogs "https://github.com/salehkhatri/aakaura/blob/main/src/app/api/blogs/route.ts"
    click API_Public_ById "https://github.com/salehkhatri/aakaura/blob/main/src/app/api/blogs/[id]/route.ts"
    click API_Public_Featured "https://github.com/salehkhatri/aakaura/blob/main/src/app/api/blogs/featured/route.ts"
    click API_Admin_Blogs "https://github.com/salehkhatri/aakaura/blob/main/src/app/api/admin/blog/route.ts"
    click API_Admin_ById "https://github.com/salehkhatri/aakaura/blob/main/src/app/api/admin/blog/[id]/route.ts"
    click API_Admin_Login "https://github.com/salehkhatri/aakaura/blob/main/src/app/api/admin/login/route.ts"
    click API_Admin_Upload "https://github.com/salehkhatri/aakaura/blob/main/src/app/api/admin/upload/route.ts"
    click API_Series "https://github.com/salehkhatri/aakaura/blob/main/src/app/api/series/route.ts"
    click API_Sitemap "https://github.com/salehkhatri/aakaura/blob/main/src/app/api/sitemap/route.ts"
    click Prisma_Migrations "https://github.com/salehkhatri/aakaura/blob/main/prisma/schema.prisma"
    click Prisma_Migrations "https://github.com/salehkhatri/aakaura/tree/main/prisma/migrations/"
    click Config_Cloudinary "https://github.com/salehkhatri/aakaura/blob/main/src/config/cloudinary.ts"
    click Config_Prismaclient "https://github.com/salehkhatri/aakaura/blob/main/src/config/prisma.ts"
    click Env_Constants "https://github.com/salehkhatri/aakaura/blob/main/src/config/env.ts"
    click Env_Constants "https://github.com/salehkhatri/aakaura/blob/main/src/config/constants.ts"
    click Fonts "https://github.com/salehkhatri/aakaura/blob/main/src/config/fonts.ts"
    click Layout_Styles "https://github.com/salehkhatri/aakaura/blob/main/src/app/layout.tsx"
    click Layout_Styles "https://github.com/salehkhatri/aakaura/blob/main/src/app/globals.css"
    click Shared_Components "https://github.com/salehkhatri/aakaura/tree/main/src/components/"
    click Context "https://github.com/salehkhatri/aakaura/blob/main/src/context/SplashScreenProvider.tsx"
    click Lib_API "https://github.com/salehkhatri/aakaura/blob/main/src/lib/api.ts"
    click Lib_SEO "https://github.com/salehkhatri/aakaura/blob/main/src/lib/seo.ts"
    click Utils_Response "https://github.com/salehkhatri/aakaura/blob/main/src/utils/response.ts"
    click Utils_Upload "https://github.com/salehkhatri/aakaura/blob/main/src/utils/upload.ts"
    click Types "https://github.com/salehkhatri/aakaura/tree/main/src/types/"
    click NextConfig "https://github.com/salehkhatri/aakaura/blob/main/next.config.ts"
    click NextConfig "https://github.com/salehkhatri/aakaura/blob/main/tailwind.config.ts"
    click NextConfig "https://github.com/salehkhatri/aakaura/blob/main/eslint.config.mjs"
    click NextConfig "https://github.com/salehkhatri/aakaura/blob/main/tsconfig.json"
    click CDN "https://github.com/salehkhatri/aakaura/tree/main/public/"

    %% Styles
    classDef ui fill:#D6EFFF,stroke:#0366D6,color:#0366D6
    classDef api fill:#FFEFD6,stroke:#D98806,color:#BA4900
    classDef db fill:#E6FFDD,stroke:#2E7D32,color:#2E7D32
    classDef ext fill:#F0D6FF,stroke:#6A1B9A,color:#6A1B9A
    classDef util fill:#F5F5F5,stroke:#CCCCCC,color:#666666
```
