How kushalaroraa/postflowai works
PostFlowAI takes a user from a topic and persona/style choices through AI-generated copy and timing advice, editing and image attachment, then saving, scheduling, tracking, or publishing a post. The React client uses the Express API; post data is modeled in MongoDB, and AI generation uses Gemini. The README also documents dashboard and calendar capabilities. Their page paths are present in the tree, but their implementation details were not sampled, so only their documented role is represented.
Main entry points: postController.js Post controller · App.jsx Client router · posts.js Post routes · GeneratePost.jsx AI Studio
Components 19
Content workspace
- Client router
client/src/App.jsx - Landing page
client/src/pages/LandingPage.jsx - AI Studio
client/src/pages/GeneratePost.jsx - Dashboard
client/src/pages/Dashboard.jsx - Calendar
client/src/pages/CalendarView.jsx - Post card
client/src/components/PostCard.jsx
Post API
- Express server
server/index.js - Post routes
server/routes/posts.js - Upload route
server/routes/uploads.js - Post controller
server/controllers/postController.js
AI generation
- Post generator
agent/executor.js - AI call logger
agent/logger.js
Storage and publishing
- Post memory
agent/memory.js - Post model
server/models/Post.js - MongoDB
- X integration
server/integrations/x.js
Other components
- User
- X platform
- Google Gemini
Connections 23
- User → Client router: uses
- Client router → Landing page: routes to
- Client router → AI Studio: routes to
- Client router → Dashboard: routes to
- Client router → Calendar: routes to
- Dashboard → Post card: renders posts
- Calendar → Post card: renders posts
- AI Studio → Post routes: requests generation
- AI Studio → Upload route: uploads image
- AI Studio → Post routes: updates schedule
- Post card → Post routes: manages posts
- Express server → Post routes: mounts routes
- Express server → Upload route: mounts routes
- Post routes → Post controller: dispatches requests
- Post controller → Post generator: generates content
- Post generator → Google Gemini: requests generation
- Post generator → AI call logger: logs call
- Post controller → AI call logger: logs generation
- Post controller → Post memory: saves generated post
- Post controller → Post model: reads and updates
- Post model → MongoDB: persists posts
- Post controller → X integration: publishes post
- X integration → X platform: simulates publishing