How amey-nagotkar/blog-generator works
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: App.jsx Workflow state · index.js Express API · client.js API client · draft.js Section endpoint
Components 19
Writing workflow
- Workflow state
client/src/App.jsx - Mode header
client/src/components/Header.jsx - Step navigation
client/src/components/Stepper.jsx - Topic and keywords
client/src/components/Step1TopicForm.jsx - Outline review
client/src/components/Step2OutlineEditor.jsx - Section drafting
client/src/components/Step3DraftGeneration.jsx - SEO and export
client/src/components/Step4SeoScorePanel.jsx
API orchestration
- API client
client/src/api/client.js - Express API
server/src/index.js - Request validation
server/src/middleware/validation.js - Error responses
server/src/middleware/errorHandler.js
Content generation
- Keyword endpoint
server/src/routes/keywords.js - Outline endpoint
server/src/routes/outline.js - Section endpoint
server/src/routes/draft.js - LLM and mock generation
server/src/services/llmClient.js
SEO audit
- Score endpoint
server/src/routes/score.js - SEO analysis
server/src/seo/scoring.js
Other components
- Writer
- Google Gemini
Connections 31
- Writer → Topic and keywords: enters topic
README.md - Workflow state → Mode header: renders
client/src/App.jsx - Workflow state → Step navigation: renders
client/src/App.jsx - Workflow state → Topic and keywords: renders
client/src/App.jsx - Workflow state → Outline review: renders
client/src/App.jsx - Workflow state → Section drafting: renders
client/src/App.jsx - Workflow state → SEO and export: renders
client/src/App.jsx - Topic and keywords → API client: uses
client/src/components/Step1TopicForm.jsx - Workflow state → API client: requests health
client/src/App.jsx - Workflow state → API client: requests outline
client/src/App.jsx - Workflow state → API client: requests sections
client/src/App.jsx - Workflow state → API client: requests score
client/src/App.jsx - Writer → Outline review: reviews outline
README.md - Writer → SEO and export: exports draft
README.md - API client → Express API: HTTP requests
client/src/api/client.js - Express API → Keyword endpoint: mounts route
server/src/index.js - Express API → Outline endpoint: mounts route
server/src/index.js - Express API → Section endpoint: mounts route
server/src/index.js - Express API → Score endpoint: mounts route
server/src/index.js - Express API → Error responses: handles errors
server/src/index.js - Keyword endpoint → Request validation: validates with
server/src/routes/keywords.js - Outline endpoint → Request validation: validates with
server/src/routes/outline.js - Section endpoint → Request validation: validates with
server/src/routes/draft.js - Keyword endpoint → LLM and mock generation: requests suggestions
server/src/routes/keywords.js - Outline endpoint → LLM and mock generation: generates outline
server/src/routes/outline.js - Section endpoint → LLM and mock generation: generates section
server/src/routes/draft.js - Section endpoint → SEO analysis: counts words
server/src/routes/draft.js - Score endpoint → SEO analysis: runs audit
server/src/routes/score.js - LLM and mock generation → Google Gemini: calls model
server/src/services/llmClient.js - Writer → Section drafting: requests drafting
README.md - Writer → SEO and export: reviews audit
README.md