Skip to content

Repository files navigation

Reddit Mastermind Documentation

A production-quality Reddit content planning and generation tool designed to create authentic, natural-sounding conversations that are indistinguishable from genuine Reddit interactions.

Documentation Index

Document Description
System Architecture High-level system design and component overview
Core Algorithm Planning algorithm, distribution logic, and safeguards
Quality Evaluation Scoring system and warning detection
Data Models Database schema and relationships
API Reference Edge functions and endpoints

Quick Start

  1. Import Campaign Data - Upload Excel/CSV with company info, personas, subreddits, and keywords
  2. Configure Settings - Set posts per week and review imported data
  3. Generate Calendar - Click "Generate Next Week" or use batch generation
  4. Evaluate Quality - Run quality evaluation to score content
  5. Export - Download CSV for posts and comments

Tech Stack

  • Frontend: React 18 + Vite + TypeScript + Tailwind CSS
  • Backend: Supabase (Cloud)
  • AI: (Gemini 2.5 Flash)
  • State Management: TanStack Query
  • UI Components: shadcn/ui

Key Principles

  1. Quality First - Content must pass rigorous authenticity checks
  2. Natural Distribution - Avoid patterns that reveal automation
  3. Persona Consistency - Each persona maintains unique voice
  4. Subtle Integration - Product mentions feel organic, never forced

Use your preferred IDE

If you want to work locally using your own IDE, you can clone this repo and push changes. Pushed changes will also be reflected in Lovable.

The only requirement is having Node.js & npm installed - install with nvm

Follow these steps:

# Step 1: Clone the repository using the project's Git URL.
git clone <YOUR_GIT_URL>

# Step 2: Navigate to the project directory.
cd <YOUR_PROJECT_NAME>

# Step 3: Install the necessary dependencies.
npm i

# Step 4: Start the development server with auto-reloading and an instant preview.
npm run dev

What technologies are used for this project?

This project is built with:

  • Vite
  • TypeScript
  • React
  • shadcn-ui
  • Tailwind CSS

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages