# karanxrathod/annadata-ai architecture

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

- Interactive diagram: https://gitdiagram.com/karanxrathod/annadata-ai
- Repository: https://github.com/karanxrathod/annadata-ai

## Overview

##### Project type and purpose
- This is a full-stack web application starter built with Next.js (app router) and designed to deploy on Firebase Hosting (apphosting.yaml).
- The primary features are three AI-driven “flows” (crop diagnosis, government schemes navigation, real-time market analysis), surfaced through React UI components and powered by a local GenKit/flows library.

##### File structure
- Top-level:
- next.config.ts, tsconfig.json, tailwind.config.ts, postcss.config.mjs – client/server build and styling configuration
- apphosting.yaml – Firebase Hosting configuration
- package.json / package-lock.json – dependencies and scripts
- src/app – Next.js “app router” pages and global layout (layout.tsx, page.tsx, globals.css)
- src/ai – server-side AI logic and orchestration
- genkit.ts – shared AI helper library
- flows/*.ts – individual AI workflows
- src/components – React UI library
- features – feature-specific pages (crop-diagnosis, govt-schemes, market-analysis)
- layout – global header/footer
- ui – atom- and molecule-level building blocks (buttons, accordions, dialogs, etc.)
- src/hooks & src/lib – custom React hooks and utility functions
- docs – markdown describing system blueprints

##### README
- The README simply states “NextJS starter in Firebase Studio” and points to src/app/page.tsx as the entry point.

##### Detail & coverage
- Don’t just show “frontend” and “backend.” Break out:
- UI Library vs. Feature Components
- Next.js Routing vs. Server Components vs. API Routes
- AI GenKit core vs. individual flow modules
- External AI provider vs. Firebase runtime
- Data flow: user → UI → server → AI → server → UI → user.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% Client Layer
  subgraph "Client (Browser)"
    Header["Header"]:::frontend
    Footer["Footer"]:::frontend
    CropComp["Crop Diagnosis Component"]:::frontend
    GovtComp["Government Schemes Component"]:::frontend
    MarketComp["Market Analysis Component"]:::frontend
    UIAtoms["UI Atoms & Molecules"]:::frontend
  end

  %% Next.js Server Layer
  subgraph "Next.js App Server"
    PageNode["Page (src/app/page.tsx)"]:::backend
    LayoutNode["Layout (src/app/layout.tsx)"]:::backend
    CSSNode["Global Styles (src/app/globals.css)"]:::frontend
    API["API Routes"]:::backend
  end

  %% AI Service Layer
  subgraph "AI Service Layer"
    GenKit["GenKit Core"]:::backend
    DevOrch["AI Dev & Orchestrator"]:::backend
    Flow1["Flow: Diagnose Crop Disease"]:::backend
    Flow2["Flow: Navigate Government Schemes"]:::backend
    Flow3["Flow: Real-Time Market Analysis"]:::backend
  end

  %% External Services
  subgraph "External AI Providers"
    OpenAI["OpenAI / Custom ML Endpoints"]:::external
  end

  %% Deployment & Infra
  subgraph "Deployment Infrastructure"
    FirebaseHost["Firebase Hosting"]:::infra
  end

  %% Config & Documentation
  subgraph "Config & Documentation"
    NextCfg["next.config.ts"]:::infra
    TSConfig["tsconfig.json"]:::infra
    Tailwind["tailwind.config.ts"]:::infra
    PostCSS["postcss.config.mjs"]:::infra
    HostConfig["Firebase Hosting Config (apphosting.yaml)"]:::infra
    UtilsNode["Utils Library (src/lib/utils.ts)"]:::backend
    HookNode["Hook: use-toast (src/hooks/use-toast.ts)"]:::frontend
    DocsNode["Blueprint Doc (docs/blueprint.md)"]:::infra
  end

  %% Data Flows
  CropComp -->|"user clicks"| PageNode
  GovtComp -->|"user clicks"| PageNode
  MarketComp -->|"user clicks"| PageNode
  Header -->|"rendered by"| LayoutNode
  Footer -->|"rendered by"| LayoutNode
  PageNode -->|"applies styles"| CSSNode
  PageNode -->|"routes to"| API
  API -->|"invokes"| GenKit
  GenKit -->|"orchestrates"| Flow1
  GenKit -->|"orchestrates"| Flow2
  GenKit -->|"orchestrates"| Flow3
  Flow1 -->|"calls API"| OpenAI
  Flow2 -->|"calls API"| OpenAI
  Flow3 -->|"calls API"| OpenAI
  PageNode -->|"deployed to"| FirebaseHost
  API -->|"functions on"| FirebaseHost

  %% Click Events
  click Header "https://github.com/karanxrathod/annadata-ai/blob/master/src/components/layout/header.tsx"
  click Footer "https://github.com/karanxrathod/annadata-ai/blob/master/src/components/layout/footer.tsx"
  click CropComp "https://github.com/karanxrathod/annadata-ai/blob/master/src/components/features/crop-diagnosis.tsx"
  click GovtComp "https://github.com/karanxrathod/annadata-ai/blob/master/src/components/features/govt-schemes.tsx"
  click MarketComp "https://github.com/karanxrathod/annadata-ai/blob/master/src/components/features/market-analysis.tsx"
  click UIAtoms "https://github.com/karanxrathod/annadata-ai/tree/master/src/components/ui"
  click PageNode "https://github.com/karanxrathod/annadata-ai/blob/master/src/app/page.tsx"
  click LayoutNode "https://github.com/karanxrathod/annadata-ai/blob/master/src/app/layout.tsx"
  click CSSNode "https://github.com/karanxrathod/annadata-ai/blob/master/src/app/globals.css"
  click GenKit "https://github.com/karanxrathod/annadata-ai/blob/master/src/ai/genkit.ts"
  click DevOrch "https://github.com/karanxrathod/annadata-ai/blob/master/src/ai/dev.ts"
  click Flow1 "https://github.com/karanxrathod/annadata-ai/blob/master/src/ai/flows/diagnose-crop-disease.ts"
  click Flow2 "https://github.com/karanxrathod/annadata-ai/blob/master/src/ai/flows/navigate-government-schemes.ts"
  click Flow3 "https://github.com/karanxrathod/annadata-ai/blob/master/src/ai/flows/real-time-market-analysis.ts"
  click NextCfg "https://github.com/karanxrathod/annadata-ai/blob/master/next.config.ts"
  click TSConfig "https://github.com/karanxrathod/annadata-ai/blob/master/tsconfig.json"
  click Tailwind "https://github.com/karanxrathod/annadata-ai/blob/master/tailwind.config.ts"
  click PostCSS "https://github.com/karanxrathod/annadata-ai/blob/master/postcss.config.mjs"
  click HostConfig "https://github.com/karanxrathod/annadata-ai/blob/master/apphosting.yaml"
  click UtilsNode "https://github.com/karanxrathod/annadata-ai/blob/master/src/lib/utils.ts"
  click HookNode "https://github.com/karanxrathod/annadata-ai/blob/master/src/hooks/use-toast.ts"
  click DocsNode "https://github.com/karanxrathod/annadata-ai/blob/master/docs/blueprint.md"

  %% Styles
  classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6;
  classDef backend fill:#E0FFE0,stroke:#028A02,color:#028A02;
  classDef external fill:#FFE0B2,stroke:#E67700,color:#E67700;
  classDef infra fill:#F0F0F0,stroke:#888888,color:#555555;
```
