# vaibhavghugretkar/majorproject architecture

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

- Interactive diagram: https://gitdiagram.com/vaibhavghugretkar/majorproject
- Repository: https://github.com/vaibhavghugretkar/majorproject

## Overview

##### File structure
- Top-level configs: `next.config.ts`, `tailwind.config.ts`, `tsconfig.json`, Firebase hosting (`apphosting.yaml`), Nix dev env (`.idx/dev.nix`).
- `src/app`: Next.js App Router pages & layouts (`page.tsx`, `layout.tsx`, global CSS).
- `src/contexts` & `src/hooks`: client-side state (auth context) and custom hooks (useAuth, useToast, useMobile).
- Legacy `src/pages/api/users.ts`: single API route for user list (optional coverage).

##### README for additional insights
- Confirms this is a Next.js starter template in “Firebase Studio.”
- Points at `src/app/page.tsx` as the main entry for the home page.

##### Elements
- Green for backend services/functions
- Orange for external services (Firebase, OpenAI)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User
    User["User"]:::frontend

    %% Frontend Layer
    subgraph "Next.js Frontend"
        PageHome["Home Page"]:::frontend
        Layout["Layout"]:::frontend
        DiagramPage["Diagram Page"]:::frontend
        LoginPage["Login Page"]:::frontend
        RegisterPage["Register Page"]:::frontend
        GlobalsCSS["Globals.css"]:::frontend
        subgraph "React Components"
            AuthLoginForm["LoginForm"]:::frontend
            AuthRegisterForm["RegisterForm"]:::frontend
            DiagramPromptForm["PromptForm"]:::frontend
            DiagramView["DiagramView"]:::frontend
            CodeView["CodeView"]:::frontend
            ExportControls["ExportControls"]:::frontend
            AppHeader["AppHeader"]:::frontend
            Logo["Logo"]:::frontend
            UIComponents["UI Generic"]:::frontend
        end
    end

    %% Backend Layer
    subgraph "API Layer"
        AuthLoginAPI["Login API"]:::backend
        AuthSignupAPI["Signup API"]:::backend
        ChatsAPI["Chats API"]:::backend
        DiagramsSaveAPI["Diagrams Save API"]:::backend
        DiagramsUserAPI["Diagrams User API"]:::backend
    end

    subgraph "AI Engine"
        DiagGen["Diagram Generation Flow"]:::backend
        DiagSum["Diagram Summarization Flow"]:::backend
        GenKit["GenKit Wrapper"]:::backend
    end

    subgraph "Utils & Data Layer"
        FirebaseInit["Firebase Init"]:::backend
        Firestore["Firestore DB"]:::backend
        MermaidUtils["Mermaid Utils"]:::backend
        GeneralUtils["General Utils"]:::backend
    end

    %% External Services
    subgraph "External Services"
        FirebaseAuth["Firebase Auth"]:::external
        ExternalLLM["LLM Provider"]:::external
    end

    %% Connections: Frontend to API
    User --> PageHome
    PageHome -->|"calls API"| ChatsAPI
    DiagramPage -->|"calls API"| DiagramsSaveAPI
    LoginPage -->|"calls API"| AuthLoginAPI
    RegisterPage -->|"calls API"| AuthSignupAPI
    PageHome -->|"uses layout/css"| Layout
    Layout --> GlobalsCSS

    %% API to Services
    AuthLoginAPI -->|"verify/auth"| FirebaseAuth
    AuthSignupAPI -->|"create user"| FirebaseAuth
    ChatsAPI -->|"CRUD Chats"| Firestore
    DiagramsSaveAPI -->|"save diagram"| Firestore
    DiagramsUserAPI -->|"fetch diagrams"| Firestore

    %% API to AI Engine
    DiagramsSaveAPI -->|"invoke"| DiagGen
    ChatsAPI -->|"invoke summarization"| DiagSum

    %% AI Engine internals
    DiagGen -->|"prompt"| ExternalLLM
    DiagGen -->|"render syntax"| MermaidUtils
    DiagSum -->|"prompt"| ExternalLLM
    DiagGen --> GenKit
    DiagSum --> GenKit

    %% Utils & Data dependencies
    FirebaseInit --> FirebaseAuth
    FirebaseInit --> Firestore
    GenKit --> ExternalLLM
    MermaidUtils --> GeneralUtils

    %% Click Events: Frontend files
    click PageHome "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/page.tsx"
    click Layout "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/layout.tsx"
    click DiagramPage "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/diagram/page.tsx"
    click LoginPage "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/login/page.tsx"
    click RegisterPage "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/register/page.tsx"
    click GlobalsCSS "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/globals.css"
    click AuthLoginForm "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/components/auth/login-form.tsx"
    click AuthRegisterForm "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/components/auth/register-form.tsx"
    click DiagramPromptForm "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/components/diagram/prompt-form.tsx"
    click DiagramView "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/components/diagram/diagram-view.tsx"
    click CodeView "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/components/diagram/code-view.tsx"
    click ExportControls "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/components/diagram/export-controls.tsx"
    click AppHeader "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/components/layout/app-header.tsx"
    click Logo "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/components/logo.tsx"
    click UIComponents "https://github.com/vaibhavghugretkar/majorproject/tree/main/src/components/ui"

    %% Click Events: API Layer
    click AuthLoginAPI "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/api/auth/login/route.ts"
    click AuthSignupAPI "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/api/auth/signup/route.ts"
    click ChatsAPI "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/api/chats/[userId]/route.ts"
    click DiagramsSaveAPI "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/api/diagrams/save/route.js"
    click DiagramsUserAPI "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/app/api/diagrams/user/[userId]/route.js"

    %% Click Events: AI Engine
    click DiagGen "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/ai/flows/diagram-generation.ts"
    click DiagSum "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/ai/flows/diagram-summarization.ts"
    click GenKit "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/ai/genkit.ts"

    %% Click Events: Utils & Data
    click FirebaseInit "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/lib/firebase.ts"
    click Firestore "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/lib/db.ts"
    click MermaidUtils "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/lib/mermaid-utils.ts"
    click GeneralUtils "https://github.com/vaibhavghugretkar/majorproject/blob/main/src/lib/utils.ts"

    %% Class Definitions
    classDef frontend fill:#bbdefb,stroke:#000,stroke-width:1px
    classDef backend fill:#c8e6c9,stroke:#000,stroke-width:1px
    classDef external fill:#ffe0b2,stroke:#000,stroke-width:1px
```
