ReditFast

AI-Powered Reddit Marketing Platform
Grow on Reddit without getting banned. Generate personalized roadmaps, create engaging content, and schedule posts—all while staying compliant with Reddit's rules.

📖 Docs • ⚡ Quick Start • 🎯 Tasks

---

👋 New Here?

🆕 New Developer? → Start with QUICKSTART.md
⚙️ Setting up locally? → Follow SETUP.md
🎯 Looking for tasks? → Check TASK_ASSIGNMENTS.md
🤖 AI Agent / Contributor? → Read AGENTS.md

---

Features

Smart Roadmap Generation

• AI analyzes your product and finds the best subreddits
• Personalized 30-day posting strategy
• Daily task recommendations with optimal timing
• Karma-building progression for new accounts

AI Content Creation

• Generate post drafts tailored to each subreddit
• Comment suggestions for high-engagement threads
• Multiple variants to choose from
• Compliance scoring to prevent removals

Scheduling & Automation

• Queue posts for optimal times
• Human-in-the-loop approval (never auto-post)
• Automatic publishing at scheduled time
• Retry logic with exponential backoff

Smart Thread Discovery

• Find trending discussions in your niche
• Comment opportunity scoring
• Real-time alerts for high-value threads
• Competitor mention tracking

Analytics & Insights

• Track karma growth and post performance
• Removal detection and account health
• Click attribution with UTM tracking
• Conversion funnel analysis

Ban Prevention

• Subreddit rule checking before every post
• Pacing controls based on account tier
• Promotional language detection
• Duplicate content prevention

---

Quick Start

New developer? See SETUP.md for detailed setup instructions.

One-Command Setup

git clone https://github.com/tanayyo1/ReditFast.git
cd ReditFast
./scripts/setup-local.sh  # Automatically sets up everything!

Manual Setup

Prerequisites:

• Node.js 18+
• PostgreSQL 14+ (with pgvector extension)
• Redis 6+
• Docker (recommended for local database)

Installation:

# Clone and install
git clone https://github.com/tanayyo1/ReditFast.git
cd ReditFast
npm install

# Set up environment
cp .env.example .env.local
# Edit .env.local with your credentials (see SETUP.md)

# Start local database
docker-compose up -d

# Set up database schema
npx prisma db push

# Verify launch readiness
npm run check:launch

# Start development
npm run dev

# Start worker (auto-loads .env.local)
npm run worker:dev

# Run localhost smoke checks (routes + key APIs)
npm run smoke:local

• 📖 Full setup guide: SETUP.md
• 🚦 Launch readiness: docs/LAUNCH_READINESS.md
• 📋 Team tasks: TASK_ASSIGNMENTS.md
• ✅ Project status: TODO.md

Visit http://localhost:3000 to see the app.

Environment Variables

Create .env.local with:

# Database
DATABASE_URL="postgresql://user:pass@localhost:5432/reditfast"

# Redis
REDIS_URL="redis://localhost:6379"

# Reddit OAuth
REDDIT_CLIENT_ID="your_client_id"
REDDIT_CLIENT_SECRET="your_client_secret"
REDDIT_REDIRECT_URI="http://localhost:3000/api/reddit/oauth/callback"
TOKEN_ENCRYPTION_KEYS="v1:replace_with_base64_32_byte_key"

# OpenAI
OPENAI_API_KEY="sk-..."

# Polar (billing)
POLAR_ACCESS_TOKEN="polar_at_..."
POLAR_WEBHOOK_SECRET="..."
POLAR_PRODUCT_PRO="..."
POLAR_PRODUCT_ENTERPRISE="..."

# NextAuth
NEXTAUTH_SECRET="your_secret_key"
NEXTAUTH_URL="http://localhost:3000"

# Email
RESEND_API_KEY="re_..."

---

Architecture

High-Level Overview

Frontend (Next.js 14)
    ↓
API Gateway (Rate Limiting, Auth)
    ↓
Microservices
├── Auth Service
├── Project Service
├── Reddit Integration
├── Roadmap Generator
├── Content AI (LLM)
├── Scheduler & Publisher
├── Analytics Engine
└── Notification Service
    ↓
Data Layer
├── PostgreSQL (Primary)
├── Redis (Cache + Queue)
├── Vector DB (Embeddings)
└── Object Storage (R2)

Key Technologies

• Frontend: Next.js 14, TailwindCSS, shadcn/ui
• Backend: Node.js, Next.js API Routes
• Database: PostgreSQL + Prisma ORM
• Queue: BullMQ (Redis-based)
• AI: OpenAI GPT-4, LangChain, pgvector
• Auth: Supabase Auth + Reddit OAuth
• Payments: Polar
• Email: Resend

See ARCHITECTURE.md for detailed design.

---

Documentation

• Architecture - System design and patterns
• API Reference - REST API documentation
• Database Schema - Prisma schema
• Deployment - Production setup guide
• Contributing - Contribution guidelines

---

Testing

# Run unit tests
npm run test:unit

# Run integration tests
npm run test:integration

# Run E2E tests
npm run test:e2e

# Run all tests
npm run test

---

Deployment

Vercel (Recommended for Frontend)

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel --prod

Railway/Render (Backend Workers)

# Deploy workers
npm run deploy:workers

See DEPLOYMENT.md for detailed instructions.

---

Roadmap

MVP (Current)

• User authentication & workspaces
• Reddit OAuth integration
• Project creation & management
• AI roadmap generation
• Draft creation with compliance scoring
• Post scheduling & publishing
• Basic analytics

Upcoming

• Smart thread finder
• Team collaboration
• Advanced analytics dashboard
• Multi-platform (LinkedIn, X)
• AI assistant (Bear)
• Mobile app

---

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

---

License

This project is licensed under the MIT License - see LICENSE for details.

---

Acknowledgments

• Inspired by MediaFast and the need for safe Reddit marketing
• Built with modern open-source tools
• Thanks to all contributors and early users

---

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: support@reditfast.com

---

Built with care for the indie founder community