# saurav-kalaskar/interview-ace-zoom-guide architecture

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

- Interactive diagram: https://gitdiagram.com/saurav-kalaskar/interview-ace-zoom-guide
- Repository: https://github.com/saurav-kalaskar/interview-ace-zoom-guide

## Overview

##### Project type and purpose
- This is a single-page web application (SPA) built with React and TypeScript, bundled by Vite, styled using Tailwind CSS, and leveraging the shadcn-ui component library.
- Its purpose is to let users set up mock interviews: upload resumes, input API keys, simulate interview questions, and display feedback powered by an AI backend (e.g., Gemini).

##### File structure
- Top-level files and configs:
- vite.config.ts, tsconfig*.json, tailwind.config.ts – build, language, and styling configuration
- index.html – application entry point
- package.json, bun.lockb, package-lock.json – dependencies & scripts
- src/ directory:
- src/main.tsx − bootstraps React app into index.html
- src/App.tsx, src/App.css − root component and global styles
- src/pages/Index.tsx, NotFound.tsx – route targets (SPA pages)
- src/components/… – feature and UI components (ResumeUpload, InterviewSetup, FeedbackPanel, ApiKeyInput)
– src/components/ui/… – shadcn-ui wrapper and customizations for common widgets (buttons, dialogs, forms, etc.)
- src/context/ApiContext.tsx – React Context for storing API credentials
- src/hooks/… – custom hooks for responsiveness (use-mobile) and toasts (use-toast)
- src/services/… – business logic for calling external APIs (geminiService.ts, interviewService.ts)
- src/lib/utils.ts – shared helper functions
- public/ – static assets (robots.txt, etc.)

##### README for additional insights
- Confirms core technologies: Vite, React, TypeScript, shadcn-ui, Tailwind CSS
- Mentions Lovable platform for live editing, automatic commits, and publishing
- No other backend code – implies the app interacts with external AI services only

## Diagram (Mermaid)

```mermaid
flowchart TB
  %% Application Bootstrap
  subgraph "Application Bootstrap"
    direction TB
    Main["src/main.tsx"]:::code
    App["src/App.tsx"]:::code
    Main -->|"renders"| App
  end

  %% Presentation Layer
  subgraph "Presentation Layer (React UI)" 
    direction TB
    Pages["Pages"]:::ui
    Components["Feature Components"]:::ui
    UILib["UI Library (shadcn-ui)"]:::ui

    Pages -->|uses| Components
    Components -->|styled by| UILib
    App -->|routes to| Pages
  end

  %% Pages
  subgraph "Pages"
    direction TB
    IndexPage["Index.tsx"]:::ui
    NotFoundPage["NotFound.tsx"]:::ui
  end
  click IndexPage "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/pages/Index.tsx"
  click NotFoundPage "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/pages/NotFound.tsx"

  %% Feature Components
  subgraph "Components"
    direction TB
    ResumeUpload["ResumeUpload.tsx"]:::ui
    InterviewSetup["InterviewSetup.tsx"]:::ui
    InterviewQuestion["InterviewQuestion.tsx"]:::ui
    ApiKeyInput["ApiKeyInput.tsx"]:::ui
    FeedbackPanel["FeedbackPanel.tsx"]:::ui
  end
  click ResumeUpload "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/components/ResumeUpload.tsx"
  click InterviewSetup "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/components/InterviewSetup.tsx"
  click InterviewQuestion "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/components/InterviewQuestion.tsx"
  click ApiKeyInput "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/components/ApiKeyInput.tsx"
  click FeedbackPanel "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/components/FeedbackPanel.tsx"
  click UILib "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/tree/main/src/components/ui/"

  %% State & Hooks Layer
  subgraph "State & Hooks Layer" 
    direction TB
    ApiContext["ApiContext Provider"]:::state
    UseMobile["use-mobile hook"]:::state
    UseToast["use-toast hook"]:::state
  end
  click ApiContext "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/context/ApiContext.tsx"
  click UseMobile "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/hooks/use-mobile.tsx"
  click UseToast "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/hooks/use-toast.ts"

  %% Business Logic Layer
  subgraph "Business Logic Layer" 
    direction TB
    InterviewService["interviewService.ts"]:::service
    GeminiService["geminiService.ts"]:::service
  end
  click InterviewService "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/services/interviewService.ts"
  click GeminiService "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/services/geminiService.ts"

  %% Shared Utilities
  Utils["utils.ts"]:::service
  click Utils "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/src/lib/utils.ts"

  %% External Systems
  subgraph "External Systems" 
    direction TB
    GeminiAPI["AI API (e.g., Google Gemini)"]:::external
    Lovable["Lovable CI/CD & Hosting"]:::external
  end

  %% Build & Deployment
  subgraph "Build & Deployment"
    direction TB
    Vite["vite.config.ts"]:::deployment
    Tailwind["tailwind.config.ts"]:::deployment
    PostCSS["postcss.config.js"]:::deployment
    TSConfig["tsconfig*.json"]:::deployment
    HTML["index.html"]:::deployment
    Robots["public/robots.txt"]:::deployment
  end
  click Vite "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/vite.config.ts"
  click Tailwind "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/tailwind.config.ts"
  click PostCSS "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/postcss.config.js"
  click TSConfig "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/tsconfig.json"
  click HTML "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/index.html"
  click Robots "https://github.com/saurav-kalaskar/interview-ace-zoom-guide/blob/main/public/robots.txt"

  %% Relationships
  App -->|provides context| ApiContext
  App -->|uses hooks| UseMobile
  App -->|uses hooks| UseToast
  ResumeUpload -->|reads/writes| ApiContext
  ApiKeyInput -->|updates| ApiContext
  InterviewSetup -->|calls| InterviewService
  InterviewQuestion -->|calls| InterviewService
  FeedbackPanel -->|calls| GeminiService
  InterviewService -->|calls| GeminiService
  GeminiService -->|HTTP requests| GeminiAPI
  InterviewService -->|utilizes| Utils
  GeminiService -->|utilizes| Utils
  Vite -->|bundles assets| HTML
  Tailwind -->|processes CSS| HTML
  HTML -->|deployed to| Lovable
  Vite -->|deploys via| Lovable

  %% Styles
  classDef ui fill:#BBDEFB,stroke:#0D47A1,color:#0D47A1;
  classDef state fill:#C8E6C9,stroke:#256029,color:#256029;
  classDef service fill:#FFE0B2,stroke:#E65100,color:#E65100;
  classDef external fill:#E0E0E0,stroke:#424242,color:#424242;
  classDef deployment fill:#E1BEE7,stroke:#6A1B9A,color:#6A1B9A;
  classDef code fill:#FFF9C4,stroke:#F57F17,color:#F57F17;
```
