# anthozb3x/promptchef architecture

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

- Interactive diagram: https://gitdiagram.com/anthozb3x/promptchef
- Repository: https://github.com/anthozb3x/promptchef

## Overview

##### Project type and purpose
- This is a full-stack Next.js web application (bootstrapped with create-next-app) whose primary function is to let authenticated users generate “prompts” (via an API route) and view/manage their prompt history. Authentication and data storage are handled through Supabase.

##### File structure
- Top-level:
- public/ – static assets
- src/app/ – Next.js App Router directory (server and client entrypoints, layouts, pages, API routes)
- src/components/ – reusable React UI components (Auth, Navbar, PromptForm, PromptHistorySidebar, etc.)
- src/lib/ – shared libraries (PromptService for business logic, supabase client)
- next.config.ts, tsconfig.json, ESLint and PostCSS configs, package.json – build and lint/dependency configs
- Under src/app:
- api/generate-prompt/route.ts – serverless API route for prompt generation
- auth/page.tsx – sign-in/up UI
- layout.tsx, globals.css, metadata.ts – site-wide layout, global styles, SEO metadata
- page.tsx – home page UI
- Patterns:
- Next.js App Router (React Server Components + Client Components)
- Serverless function for “generate prompt” logic
- Supabase integration for Auth and Realtime/Database

##### README for additional insights
- Confirms Next.js, next/font usage for font optimization, standard create-next-app structure.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client Browser"
        direction TB
        ClientUI["Client Browser (UI)"]:::frontend
    end
    click ClientUI "https://github.com/anthozb3x/promptchef/tree/master/src/app/"

    %% Next.js App Router
    subgraph "Next.js App Router"
        direction TB
        subgraph "Server Components"
            direction TB
            SSR_Home["Home Page (page.tsx)"]:::backend
            SSR_Layout["Layout (layout.tsx)"]:::backend
            SSR_AuthPage["Auth Page (auth/page.tsx)"]:::backend
        end
        subgraph "Client Components"
            direction TB
            AuthUI["Auth UI"]:::frontend
            Navbar["Navbar"]:::frontend
            PromptForm["PromptForm"]:::frontend
            PromptHistorySidebar["PromptHistorySidebar"]:::frontend
            PromptSearchHistorySidebar["PromptSearchHistorySidebar"]:::frontend
            ThemeRegistry["ThemeRegistry"]:::frontend
        end
    end
    click SSR_Home "https://github.com/anthozb3x/promptchef/blob/master/src/app/page.tsx"
    click SSR_Layout "https://github.com/anthozb3x/promptchef/blob/master/src/app/layout.tsx"
    click SSR_AuthPage "https://github.com/anthozb3x/promptchef/blob/master/src/app/auth/page.tsx"
    click AuthUI "https://github.com/anthozb3x/promptchef/blob/master/src/components/Auth.tsx"
    click Navbar "https://github.com/anthozb3x/promptchef/blob/master/src/components/Navbar.tsx"
    click PromptForm "https://github.com/anthozb3x/promptchef/blob/master/src/components/PromptForm.tsx"
    click PromptHistorySidebar "https://github.com/anthozb3x/promptchef/blob/master/src/components/PromptHistorySidebar.tsx"
    click PromptSearchHistorySidebar "https://github.com/anthozb3x/promptchef/blob/master/src/components/PromptSearchHistorySidebar.tsx"
    click ThemeRegistry "https://github.com/anthozb3x/promptchef/blob/master/src/components/ThemeRegistry.tsx"
    click NextAppRouter "https://github.com/anthozb3x/promptchef/tree/master/src/app/"
    
    %% API Layer
    API["API Route: /api/generate-prompt"]:::backend
    click API "https://github.com/anthozb3x/promptchef/blob/master/src/app/api/generate-prompt/route.ts"

    %% Business Logic
    PromptService["PromptService"]:::backend
    click PromptService "https://github.com/anthozb3x/promptchef/blob/master/src/lib/PromptService.ts"

    %% Supabase Services
    SupabaseAuth["Supabase Auth"]:::external
    SupabaseDB["Supabase Database"]:::database
    click SupabaseClient "https://github.com/anthozb3x/promptchef/blob/master/src/lib/supabase.ts"

    %% External AI
    ExternalAI["External AI Service"]:::external

    %% Static Assets & CDN
    StaticAssets["Static Assets & CDN (public/)"]:::external
    click StaticAssets "https://github.com/anthozb3x/promptchef/tree/master/public/"

    %% Font Optimization & Config
    FontOpt["Font Optimization (next/font)"]:::backend
    click FontOpt "https://github.com/anthozb3x/promptchef/blob/master/src/theme.ts"
    Configs["Project Configurations"]:::backend
    click Configs "https://github.com/anthozb3x/promptchef/blob/master/next.config.ts"

    %% Global Styles & Metadata
    GlobalsCSS["Global Styles (globals.css)"]:::backend
    click GlobalsCSS "https://github.com/anthozb3x/promptchef/blob/master/src/app/globals.css"
    Metadata["Metadata & SEO (metadata.ts)"]:::backend
    click Metadata "https://github.com/anthozb3x/promptchef/blob/master/src/app/metadata.ts"

    %% Relationships
    ClientUI -->|"navigates to /, SSR"| SSR_Home
    ClientUI -->|"requests layout"| SSR_Layout
    ClientUI -->|"access auth"| SSR_AuthPage
    ClientUI -->|"renders UI components"| AuthUI
    ClientUI --> AuthUI
    ClientUI --> Navbar
    ClientUI --> PromptForm
    ClientUI --> PromptHistorySidebar
    ClientUI --> PromptSearchHistorySidebar

    ClientUI -->|"POST /api/generate-prompt"| API
    API -->|"calls"| PromptService
    PromptService -->|"fetch/generate"| ExternalAI
    PromptService -->|"returns prompt"| API
    API -->|"response"| ClientUI

    ClientUI -->|"login/read/write"| SupabaseAuth
    ClientUI -->|"fetch prompt history"| SupabaseDB
    API -->|"validate session"| SupabaseAuth
    ClientUI -->|"persist history"| SupabaseDB

    NextAppRouter -->|"build uses"| FontOpt
    NextAppRouter -->|"serves globals"| GlobalsCSS
    NextAppRouter -->|"applies metadata"| Metadata

    NextAppRouter --> StaticAssets
    StaticAssets --> ClientUI

    Configs --- NextAppRouter

    %% Styles
    classDef frontend fill:#D0EBFF,stroke:#1E90FF,color:#000
    classDef backend fill:#E6F4EA,stroke:#2E8B57,color:#000
    classDef external fill:#FFF4E6,stroke:#FF8C00,color:#000
    classDef database fill:#F0F5F9,stroke:#1C3D5A,color:#000
```
