The Reddit Mastermind

A fullstack web application that automates Reddit content planning for client growth. The app ingests company information, personas, target subreddits, and keywords to generate high-quality weekly content calendars using AI.

🚀 Features

• Smart Content Planning: Generate weekly Reddit content calendars with AI-powered content
• Multi-Persona Support: Manage multiple personas with distinct voices and styles
• Groq AI Integration: Fast content generation using Groq's LLaMA 3.3 70B model
• AI-Powered Scoring: Automatic grading with heuristic fallback
• Thread Simulation: Preview how threads might unfold before posting
• Multi-Week Support: Generate next week with linked week navigation
• Edit & Save: Live editing and saving functionality
• Export Options: Export calendars to CSV or Excel formats

🏗️ Architecture

reddit-mastermind-automation/
├── backend/                 # Express.js API server
│   ├── src/
│   │   ├── index.js        # Main server entry
│   │   ├── routes/         # API routes
│   │   │   ├── auth.js     # Authentication routes
│   │   │   ├── planner.js  # Calendar generation & management
│   │   │   ├── export.js   # CSV/Excel export
│   │   │   └── simulator.js # Thread simulation
│   │   └── services/       # Business logic
│   │       ├── csv-xlsx-handler.js  # File parsing utilities
│   │       ├── smart-parser.js      # AI-powered file parsing
│   │       ├── persona.js           # Persona management
│   │       ├── llm-adapter.js       # Groq AI integration & scoring
│   │       ├── validator.js         # Content validation
│   │       ├── planner.js           # Calendar planning algorithm
│   │       ├── post-adapter.js      # Post management
│   │       ├── simulator.js         # Thread simulation
│   │       └── export.js            # Export utilities
│   ├── package.json
│   └── .env.example
├── frontend/               # React (Vite) application
│   ├── src/
│   │   ├── api/           # API client
│   │   │   └── index.js   # Axios API wrapper
│   │   ├── components/    # Reusable UI components
│   │   │   ├── Layout.jsx         # Main layout with sidebar
│   │   │   ├── FileUpload.jsx     # Drag & drop file upload
│   │   │   ├── PostCard.jsx       # Post display card
│   │   │   ├── EditModal.jsx      # Edit post/comments modal
│   │   │   └── CalendarSummary.jsx # Calendar stats summary
│   │   ├── pages/         # Route pages
│   │   │   ├── Dashboard.jsx      # Home dashboard
│   │   │   ├── NewPlan.jsx        # Create new calendar
│   │   │   ├── CalendarView.jsx   # View/manage calendar
│   │   │   └── Simulator.jsx      # Thread simulator
│   │   ├── store/         # State management (Zustand)
│   │   │   └── calendarStore.js
│   │   ├── App.jsx        # Main app with routes
│   │   ├── main.jsx       # Entry point
│   │   └── index.css      # Tailwind styles
│   ├── package.json
│   └── vite.config.js
├── sample_data/           # Example input files
│   ├── SlideForge - Company Info_input.csv
│   └── SlideForge - Content Calendar_output.csv
├── Output/                # Exported calendar files
├── docker-compose.yml     # Docker configuration
├── LICENSE
└── README.md

🛠️ Tech Stack

Backend

• Runtime: Node.js 20+
• Framework: Express.js
• AI: Groq SDK (LLaMA 3.3 70B Versatile)
• File Processing: papaparse (CSV), xlsx (Excel)
• Validation: Custom rule engine

Frontend

• Framework: React 18 + Vite
• Styling: Tailwind CSS
• State: Zustand
• Routing: React Router v6
• UI: Lucide icons, react-hot-toast

📋 Prerequisites

• Node.js 20.x or higher
• npm 10.x or higher
• Groq API key

🚀 Quick Start

1. Clone the repository

git clone https://github.com/yourusername/reddit-mastermind-automation.git
cd reddit-mastermind-automation

2. Backend Setup

cd backend
npm install

# Copy and configure environment variables
cp .env.example .env
# Edit .env and add your Groq API key

3. Frontend Setup

cd ../frontend
npm install

4. Start Development Servers

Backend (Terminal 1):

cd backend
npm run dev
# Server runs on http://localhost:3001

Frontend (Terminal 2):

cd frontend
npm run dev
# App runs on http://localhost:5173

📁 Input File Format

The application accepts CSV or XLSX files with company info, personas, subreddits, and keywords. The smart parser uses AI to automatically extract structured data from various file formats.

Required Data

• Company Info: Name, website, description
• Personas: Username, bio, tone, tags (minimum 2)
• Subreddits: Target subreddit names
• Keywords: Topics and angles for content

See sample_data/ for example input files.

🎯 Core Algorithm

The planner uses a sophisticated allocation algorithm:

1. Smart Parse: AI extracts company, personas, subreddits, and keywords from uploaded file
2. Expand Angles: Generate diverse post titles/angles from keywords
3. Allocate Posts: Distribute across days, personas, and subreddits
4. Generate Content: Create posts with 5 varied opening styles (story, question, observation, tip, comparison)
5. Generate Comments: Create follow-up comments with 7 diverse strategies
6. AI Scoring: Grade content for authenticity, engagement, value, and subreddit fit
7. Heuristic Fallback: Automatic scoring when AI grading fails
8. Track Variety: Prevent repetition by tracking persona comment history
9. Week Linking: Chain calendars together for multi-week navigation

📡 API Endpoints

Planner

• POST /api/planner/generate - Generate calendar from file upload
• POST /api/planner/generate/json - Generate calendar from JSON input
• GET /api/planner/calendar/:id - Get calendar by ID
• GET /api/planner/calendars - List all calendars
• POST /api/planner/calendar/:id/next-week - Generate next week's calendar
• PATCH /api/planner/calendar/:id/item/:itemId - Update item (edit)
• POST /api/planner/calendar/:id/item/:itemId/approve - Approve item for posting

Export

• GET /api/export/:id/csv - Export to CSV
• GET /api/export/:id/xlsx - Export to Excel

Simulator

• POST /api/simulator/:calendarId/:itemId - Simulate thread

🎨 UI Features

• Dashboard: View all generated calendars with quick stats
• New Plan: Upload files, preview data, configure generation options
• Calendar View: Grid/List views, filtering by persona/subreddit, week navigation
• Edit Modal: Edit post title, body, subreddit, timestamp, and all comments
• Progress Modal: Visual progress during calendar generation
• Thread Simulator: Real-time simulation of how threads unfold

📝 License

MIT License - see LICENSE for details.