# kartikp36/gitagpt architecture

> Architecture diagram of the GitHub repository kartikp36/gitagpt, 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/kartikp36/gitagpt
- Repository: https://github.com/kartikp36/gitagpt

## Overview

##### Project type and purpose
- This is a full-stack, React-based web application built with Next.js and TypeScript.
- It serves as an AI-powered chatbot (“Gita GPT”) that lets users converse with Lord Krishna, pulling in Bhagavad Gita content from Notion and generating responses via OpenAI’s ChatGPT.
- Key features: conversational UI, personalized Q&A, Notion-sourced content, user authentication via Supabase, and AI integration.

##### File structure
Top-level:
- pages/ – Next.js “pages” (route-based), including UI pages (index.tsx, about.tsx) and API routes (pages/api/generate.ts).
- components/ – React UI components (ChatBubble, ChatSection, Navbar, Header, Footer, Input & SuggestionBox, NotionPage viewer, SupaAuthModal).
- apiFunctions/ – shared front-end logic to invoke the generate endpoint.
- lib/ – server-side utility modules: config.ts (env & API keys), notion.ts (Notion API wrappers), preview-images.ts.
- utils/ – client utilities: request.tsx (HTTP helper), useTimeFormat.tsx.
- constants/ – sampleData.json for mock/testing.
- public/ – static assets (avatars).
- styles/ & tailwind.config.js – global CSS and Tailwind setup.
- next.config.js, tsconfig.json, .eslintrc.json – framework/config declarations.

##### README for insights
- Confirms core architecture: Next.js frontend + API routes, AI powered by OpenAI, content from Notion.
- Mentions user authentication (SupaAuthModal).
- No explicit persistence beyond Notion & potential Supabase.

##### Main components and interactions
a. Frontend (Next.js React):
- UI Pages (pages/*.tsx)
- Layout components (Header, Footer, Navbar)
- Chat UI (ChatSection → ChatBubble → UserDetails)
- Input components (Input, SuggestionBox)
- NotionPage renderer

b. Backend/API (Next.js API routes):
- /api/generate – accepts user prompt → calls OpenAI via utils/request → returns AI response
- (Potentially other API endpoints for auth, Notion)

c. External services:
- OpenAI API (for ChatGPT)
- Notion API (for Bhagavad Gita content)
- Supabase Auth (Supabase handles user login via SupaAuthModal)

d. Configuration & Utilities:
- lib/config.ts: centralizes environment variables (API keys, URLs)
- utils/request.tsx: abstract fetch requests to OpenAI and Notion
- lib/notion.ts: wraps Notion API calls
- preview-images.ts: generates image previews (used by NotionPage)

##### Architectural patterns and principles
- Monolithic full-stack app using Next.js’s hybrid routing (server-side & client-side).
- Layered structure:
1. Presentation Layer (React components in components/)
2. API Layer (Next.js API routes under pages/api/)
3. Integration Layer (lib/ + utils/ modules that call external services)
- Separation of concerns:
- UI vs. business logic vs. external integrations
- TypeScript for type safety across layers

- “Browser / Client” at left
- “Next.js Frontend” grouping: Pages, Components, Styles
- “Next.js Server” grouping: API Routes (/api/generate), lib modules
- “External Services”: OpenAI API, Notion API, Supabase Auth

1. User → Next.js Frontend (HTTP/React events)
2. Frontend → /api/generate (fetch)
3. /api/generate → OpenAI API (HTTPS)
4. API Route → lib/notion.ts → Notion API (HTTPS)
5. Frontend ↔ Supabase Auth (via SupaAuthModal)
6. Next.js Frontend → NotionPage component → lib/notion fetches content

c. Patterns:
- Data flow: user input → API → external AI engine → response → UI
- Shared config across server modules (lib/config)
- Reusable UI components vs. business logic modules

d. Technologies:
- Next.js (server & client)
- React + TypeScript + Tailwind CSS
- OpenAI, Notion, Supabase

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser / Client omitted as frontend encapsulates browser components

    subgraph "Next.js Frontend"
        subgraph "Pages (Routes)"
            Home["index.tsx"]:::frontend
            About["about.tsx"]:::frontend
            App["_app.tsx"]:::frontend
            Document["_document.tsx"]:::frontend
        end

        subgraph "UI Components"
            Header["Header"]:::frontend
            Navbar["Navbar"]:::frontend
            Footer["Footer"]:::frontend
            ChatSection["ChatSection"]:::frontend
            ChatBubble["ChatBubble"]:::frontend
            UserDetails["UserDetails"]:::frontend
            InputField["Input"]:::frontend
            SuggestionBox["SuggestionBox"]:::frontend
            NotionPage["NotionPage"]:::frontend
            Tooltip["Tooltip"]:::frontend
            SupaAuth["SupaAuthModal"]:::frontend
        end

        subgraph "Front-end Helper"
            FrontendGen["apiFunctions/generate.tsx"]:::util
        end

        subgraph "Client Utilities"
            Request["request.tsx"]:::util
            TimeFmt["useTimeFormat.tsx"]:::util
        end
    end

    subgraph "Next.js Server"
        subgraph "API Routes"
            GenerateAPI["generate.ts"]:::api
        end
        subgraph "Server Utilities"
            Config["config.ts"]:::util
            NotionLib["notion.ts"]:::util
            PreviewImgs["preview-images.ts"]:::util
        end
    end

    subgraph "External Services"
        OpenAI["OpenAI API"]:::service
        NotionAPI["Notion API"]:::service
        Supabase["Supabase Auth"]:::service
    end

    %% Interactions
    Home -->|"renders"| Header
    Home -->|"renders"| Navbar
    Home -->|"renders"| Footer
    Home -->|"renders"| ChatSection

    About -->|"renders"| Header
    About -->|"renders"| Navbar
    About -->|"renders"| Footer
    About -->|"renders"| NotionPage

    ChatSection -->|"contains"| ChatBubble
    ChatBubble -->|"contains"| UserDetails
    ChatSection -->|"uses"| InputField
    InputField -->|"suggestions from"| SuggestionBox
    ChatSection -->|"auth via"| SupaAuth
    SupaAuth <-->|"auth flow"| Supabase

    ChatSection -->|"onSubmit prompt"| FrontendGen
    FrontendGen -->|"calls API"| GenerateAPI
    FrontendGen -->|"uses HTTP"| Request

    GenerateAPI -->|"loads env via"| Config
    GenerateAPI -->|"queries AI"| OpenAI
    GenerateAPI -->|"fetches content"| NotionLib
    NotionLib -->|"calls"| NotionAPI
    NotionLib -->|"uses previews"| PreviewImgs

    %% Click Events
    click Home "https://github.com/kartikp36/gitagpt/blob/main/pages/index.tsx"
    click About "https://github.com/kartikp36/gitagpt/blob/main/pages/about.tsx"
    click App "https://github.com/kartikp36/gitagpt/blob/main/pages/_app.tsx"
    click Document "https://github.com/kartikp36/gitagpt/blob/main/pages/_document.tsx"
    click GenerateAPI "https://github.com/kartikp36/gitagpt/blob/main/pages/api/generate.ts"
    click ChatSection "https://github.com/kartikp36/gitagpt/blob/main/components/ChatSection.tsx"
    click ChatBubble "https://github.com/kartikp36/gitagpt/blob/main/components/ChatBubble/index.tsx"
    click UserDetails "https://github.com/kartikp36/gitagpt/blob/main/components/ChatBubble/UserDetails.tsx"
    click InputField "https://github.com/kartikp36/gitagpt/blob/main/components/Input/index.tsx"
    click SuggestionBox "https://github.com/kartikp36/gitagpt/blob/main/components/Input/SuggestionBox.tsx"
    click Header "https://github.com/kartikp36/gitagpt/blob/main/components/Header.tsx"
    click Footer "https://github.com/kartikp36/gitagpt/blob/main/components/Footer.tsx"
    click Navbar "https://github.com/kartikp36/gitagpt/blob/main/components/Navbar.tsx"
    click NotionPage "https://github.com/kartikp36/gitagpt/blob/main/components/NotionPage.tsx"
    click Tooltip "https://github.com/kartikp36/gitagpt/blob/main/components/Tooltip.tsx"
    click SupaAuth "https://github.com/kartikp36/gitagpt/blob/main/components/auth/SupaAuthModal.tsx"
    click FrontendGen "https://github.com/kartikp36/gitagpt/blob/main/apiFunctions/generate.tsx"
    click Config "https://github.com/kartikp36/gitagpt/blob/main/lib/config.ts"
    click NotionLib "https://github.com/kartikp36/gitagpt/blob/main/lib/notion.ts"
    click PreviewImgs "https://github.com/kartikp36/gitagpt/blob/main/lib/preview-images.ts"
    click Request "https://github.com/kartikp36/gitagpt/blob/main/utils/request.tsx"
    click TimeFmt "https://github.com/kartikp36/gitagpt/blob/main/utils/useTimeFormat.tsx"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#000,stroke-width:1px
    classDef api fill:#D5F5E3,stroke:#000,stroke-width:1px
    classDef service fill:#FDEBD0,stroke:#000,stroke-width:1px
    classDef util fill:#E8E8E8,stroke:#000,stroke-width:1px
```
