# amey-nagotkar/blog-generator architecture

> Architecture diagram of the GitHub repository amey-nagotkar/blog-generator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amey-nagotkar/blog-generator
- Repository: https://github.com/amey-nagotkar/blog-generator

## Overview

AI Blog Generator is a React/Express application for producing SEO-oriented blog drafts. Users enter a topic and keywords, receive an outline, review and edit it before prose generation, then draft sections and run an SEO audit; the final screen supports Markdown and text export. The client coordinates the workflow and calls the API, whose routes validate inputs and delegate generation to the LLM service or scoring to plain-code SEO analysis. Mock/live operation and keyword suggestions are documented capabilities. Some UI and server wiring is unsampled; the graph omits uncertain internal links.

Main entry points: [`client/src/App.jsx`](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/App.jsx) (Workflow state), [`server/src/index.js`](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/index.js) (Express API), [`client/src/api/client.js`](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/api/client.js) (API client), [`server/src/routes/draft.js`](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/routes/draft.js) (Section endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Writing workflow"]
  node_app["Workflow state<br/>[App.jsx]"]
  node_header["Mode header<br/>[Header.jsx]"]
  node_stepper["Step navigation<br/>[Stepper.jsx]"]
  node_topicform["Topic and keywords<br/>[Step1TopicForm.jsx]"]
  node_outlineedit["Outline review"]
  node_draftui["Section drafting"]
  node_scoreui["SEO and export"]
end

subgraph group_api["API orchestration"]
  node_apiclient["API client<br/>[client.js]"]
  node_server["Express API<br/>[index.js]"]
  node_validation["Request validation<br/>[validation.js]"]
  node_errors["Error responses<br/>[errorHandler.js]"]
end

subgraph group_generation["Content generation"]
  node_keywords["Keyword endpoint<br/>[keywords.js]"]
  node_outline["Outline endpoint<br/>[outline.js]"]
  node_draft["Section endpoint<br/>[draft.js]"]
  node_llm["LLM and mock generation<br/>[llmClient.js]"]
end

subgraph group_seo["SEO audit"]
  node_score["Score endpoint<br/>[score.js]"]
  node_scoring["SEO analysis<br/>[scoring.js]"]
end

node_writer(("Writer"))
node_gemini{{"Google Gemini"}}

node_writer -->|"enters topic"| node_topicform
node_app -->|"renders"| node_header
node_app -->|"renders"| node_stepper
node_app -->|"renders"| node_topicform
node_app -->|"renders"| node_outlineedit
node_app -->|"renders"| node_draftui
node_app -->|"renders"| node_scoreui
node_topicform -->|"uses"| node_apiclient
node_app -->|"requests health"| node_apiclient
node_app -->|"requests outline"| node_apiclient
node_app -->|"requests sections"| node_apiclient
node_app -->|"requests score"| node_apiclient
node_writer -->|"reviews outline"| node_outlineedit
node_writer -->|"exports draft"| node_scoreui
node_apiclient -->|"HTTP requests"| node_server
node_server -->|"mounts route"| node_keywords
node_server -->|"mounts route"| node_outline
node_server -->|"mounts route"| node_draft
node_server -->|"mounts route"| node_score
node_server -->|"handles errors"| node_errors
node_keywords -->|"validates with"| node_validation
node_outline -->|"validates with"| node_validation
node_draft -->|"validates with"| node_validation
node_keywords -->|"requests suggestions"| node_llm
node_outline -->|"generates outline"| node_llm
node_draft -->|"generates section"| node_llm
node_draft -->|"counts words"| node_scoring
node_score -->|"runs audit"| node_scoring
node_llm -->|"calls model"| node_gemini
node_writer -->|"requests drafting"| node_draftui
node_writer -->|"reviews audit"| node_scoreui

click node_app "https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/App.jsx"
click node_header "https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Header.jsx"
click node_stepper "https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Stepper.jsx"
click node_topicform "https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Step1TopicForm.jsx"
click node_outlineedit "https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Step2OutlineEditor.jsx"
click node_draftui "https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Step3DraftGeneration.jsx"
click node_scoreui "https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Step4SeoScorePanel.jsx"
click node_apiclient "https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/api/client.js"
click node_server "https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/index.js"
click node_validation "https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/middleware/validation.js"
click node_errors "https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/middleware/errorHandler.js"
click node_keywords "https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/routes/keywords.js"
click node_outline "https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/routes/outline.js"
click node_draft "https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/routes/draft.js"
click node_llm "https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/services/llmClient.js"
click node_score "https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/routes/score.js"
click node_scoring "https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/seo/scoring.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_header,node_stepper,node_topicform,node_outlineedit,node_draftui,node_scoreui toneBlue
class node_apiclient,node_server,node_validation,node_errors toneAmber
class node_keywords,node_outline,node_draft,node_llm toneMint
class node_score,node_scoring toneRose
class node_writer,node_gemini toneIndigo
```

## Components

### Writing workflow

- [Workflow state](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Mode header](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Header.jsx): `client/src/components/Header.jsx`
- [Step navigation](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Stepper.jsx): `client/src/components/Stepper.jsx`
- [Topic and keywords](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Step1TopicForm.jsx): `client/src/components/Step1TopicForm.jsx`
- [Outline review](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Step2OutlineEditor.jsx): `client/src/components/Step2OutlineEditor.jsx`
- [Section drafting](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Step3DraftGeneration.jsx): `client/src/components/Step3DraftGeneration.jsx`
- [SEO and export](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/components/Step4SeoScorePanel.jsx): `client/src/components/Step4SeoScorePanel.jsx`

### API orchestration

- [API client](https://github.com/amey-nagotkar/blog-generator/blob/main/client/src/api/client.js): `client/src/api/client.js`
- [Express API](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/index.js): `server/src/index.js`
- [Request validation](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/middleware/validation.js): `server/src/middleware/validation.js`
- [Error responses](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/middleware/errorHandler.js): `server/src/middleware/errorHandler.js`

### Content generation

- [Keyword endpoint](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/routes/keywords.js): `server/src/routes/keywords.js`
- [Outline endpoint](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/routes/outline.js): `server/src/routes/outline.js`
- [Section endpoint](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/routes/draft.js): `server/src/routes/draft.js`
- [LLM and mock generation](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/services/llmClient.js): `server/src/services/llmClient.js`

### SEO audit

- [Score endpoint](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/routes/score.js): `server/src/routes/score.js`
- [SEO analysis](https://github.com/amey-nagotkar/blog-generator/blob/main/server/src/seo/scoring.js): `server/src/seo/scoring.js`

### Other components

- **Writer**
- **Google Gemini**

## Connections

- Writer → Topic and keywords: enters topic (evidence: `README.md`)
- Workflow state → Mode header: renders (evidence: `client/src/App.jsx`)
- Workflow state → Step navigation: renders (evidence: `client/src/App.jsx`)
- Workflow state → Topic and keywords: renders (evidence: `client/src/App.jsx`)
- Workflow state → Outline review: renders (evidence: `client/src/App.jsx`)
- Workflow state → Section drafting: renders (evidence: `client/src/App.jsx`)
- Workflow state → SEO and export: renders (evidence: `client/src/App.jsx`)
- Topic and keywords → API client: uses (evidence: `client/src/components/Step1TopicForm.jsx`)
- Workflow state → API client: requests health (evidence: `client/src/App.jsx`)
- Workflow state → API client: requests outline (evidence: `client/src/App.jsx`)
- Workflow state → API client: requests sections (evidence: `client/src/App.jsx`)
- Workflow state → API client: requests score (evidence: `client/src/App.jsx`)
- Writer → Outline review: reviews outline (evidence: `README.md`)
- Writer → SEO and export: exports draft (evidence: `README.md`)
- API client → Express API: HTTP requests (evidence: `client/src/api/client.js`)
- Express API → Keyword endpoint: mounts route (evidence: `server/src/index.js`)
- Express API → Outline endpoint: mounts route (evidence: `server/src/index.js`)
- Express API → Section endpoint: mounts route (evidence: `server/src/index.js`)
- Express API → Score endpoint: mounts route (evidence: `server/src/index.js`)
- Express API → Error responses: handles errors (evidence: `server/src/index.js`)
- Keyword endpoint → Request validation: validates with (evidence: `server/src/routes/keywords.js`)
- Outline endpoint → Request validation: validates with (evidence: `server/src/routes/outline.js`)
- Section endpoint → Request validation: validates with (evidence: `server/src/routes/draft.js`)
- Keyword endpoint → LLM and mock generation: requests suggestions (evidence: `server/src/routes/keywords.js`)
- Outline endpoint → LLM and mock generation: generates outline (evidence: `server/src/routes/outline.js`)
- Section endpoint → LLM and mock generation: generates section (evidence: `server/src/routes/draft.js`)
- Section endpoint → SEO analysis: counts words (evidence: `server/src/routes/draft.js`)
- Score endpoint → SEO analysis: runs audit (evidence: `server/src/routes/score.js`)
- LLM and mock generation → Google Gemini: calls model (evidence: `server/src/services/llmClient.js`)
- Writer → Section drafting: requests drafting (evidence: `README.md`)
- Writer → SEO and export: reviews audit (evidence: `README.md`)
