Posty Bot - AI-Powered Social Media Scheduler

🚀 Overview

Posty Bot is a comprehensive social media management platform that combines AI-powered content generation with multi-platform posting capabilities. Built with Next.js, Node.js, and MongoDB, it provides a complete solution for managing your social media presence.

✨ Features Implemented

🎯 Core Features

• Multi-Platform Support: Twitter, LinkedIn, Instagram
• AI Content Generation: GPT-4 powered content creation with customizable tone and length
• Scheduling System: Schedule posts for optimal times using BullMQ job queue
• Real-time Analytics: Track performance and engagement metrics
• Social Account Management: OAuth integration for platform connections

🎨 Frontend Features (Enhanced Dashboard)

• Modern UI/UX: Clean, responsive design with Tailwind CSS
• Tabbed Navigation: Organized dashboard with dedicated sections
• Interactive Components: Rich forms, modals, and data visualizations
• Real-time Updates: Toast notifications and loading states
• Mobile Responsive: Optimized for all device sizes

🔧 Backend Features

• RESTful API: Comprehensive endpoints for all operations
• Authentication: JWT-based user authentication with bcrypt
• Database: MongoDB with Mongoose ODM
• Job Queue: BullMQ with Redis for background processing
• Error Handling: Comprehensive error management and logging
• Security: Rate limiting, CORS, Helmet security headers

📱 Dashboard Sections

1. Overview

• Quick Stats Cards: Posts, accounts, AI generation metrics
• Getting Started Guide: Step-by-step onboarding
• Recent Activity: Timeline of user actions
• Quick Actions: One-click shortcuts to common tasks

2. Posts Manager

• Create/Edit Posts: Rich text editor with character counting
• Platform Selection: Multi-platform targeting
• Scheduling: Date/time picker for future posting
• Status Tracking: Draft, scheduled, published, failed states
• Bulk Actions: Edit, delete, reschedule operations

3. AI Content Generator

• Topic Input: Describe your content idea
• Tone Selection: Professional, casual, humorous, inspirational, informative
• Length Options: Short (Twitter), medium (general), long (LinkedIn)
• Platform Optimization: Content tailored for specific platforms
• Image Prompts: AI-generated image descriptions
• Content Variations: Multiple content suggestions
• One-Click Publishing: Direct integration with post creation

4. Social Accounts Manager

• Platform Cards: Visual representation of each platform
• Connection Status: Real-time connection monitoring
• Account Management: Activate/deactivate, refresh tokens
• OAuth Flow: Secure platform authorization
• Usage Analytics: Per-platform posting statistics

5. Analytics Dashboard

• Performance Metrics: Success rates, engagement data
• Platform Comparison: Cross-platform performance analysis
• Activity Timeline: Historical posting activity
• Visual Charts: Bar charts, progress indicators
• Export Options: Data export capabilities

🛠 Technical Architecture

Frontend Stack

• Next.js 15: React framework with App Router
• TypeScript: Type-safe development
• Tailwind CSS: Utility-first styling
• Lucide React: Modern icon library
• React Hook Form: Form management
• React Hot Toast: Notification system

Backend Stack

• Node.js: Runtime environment
• Express.js: Web framework
• TypeScript: Type-safe server code
• MongoDB: NoSQL database
• Mongoose: ODM for MongoDB
• BullMQ: Job queue for Redis
• JWT: Authentication tokens
• bcrypt: Password hashing

External Services

• OpenAI GPT-4: Content generation
• Twitter API v2: Twitter integration
• LinkedIn API: LinkedIn integration
• Instagram Basic Display: Instagram integration
• Redis: Caching and job queue

🔧 Setup Instructions

Prerequisites

• Node.js 18+
• MongoDB (local or cloud)
• Redis (optional, for job queue)
• API keys for social platforms and OpenAI

Environment Variables

# Database
MONGODB_URI=mongodb://localhost:27017/posty_bot

# JWT
JWT_SECRET=your-secret-key

# OpenAI
OPENAI_API_KEY=your-openai-key

# Social Media APIs
TWITTER_API_KEY=your-twitter-key
TWITTER_API_SECRET=your-twitter-secret
LINKEDIN_CLIENT_ID=your-linkedin-id
LINKEDIN_CLIENT_SECRET=your-linkedin-secret
INSTAGRAM_CLIENT_ID=your-instagram-id
INSTAGRAM_CLIENT_SECRET=your-instagram-secret

# Redis (optional)
REDIS_URL=redis://localhost:6379

# Server
PORT=5000
NODE_ENV=development
FRONTEND_URL=http://localhost:3000

Installation

# Clone the repository
git clone https://github.com/your-repo/posty-bot.git
cd posty-bot

# Install backend dependencies
cd backend
npm install

# Install frontend dependencies
cd ../frontend
npm install

# Start development servers
# Terminal 1: Backend
cd backend && npm run dev

# Terminal 2: Frontend
cd frontend && npm run dev

🌐 API Endpoints

Authentication

• POST /api/auth/register - User registration
• POST /api/auth/login - User login
• GET /api/auth/me - Get current user

Posts

• GET /api/posts - Get user posts
• POST /api/posts - Create new post
• PUT /api/posts/:id - Update post
• DELETE /api/posts/:id - Delete post

AI Generation

• POST /api/ai/generate-content - Generate AI content
• POST /api/ai/generate-image - Generate image prompts

Social Accounts

• GET /api/social/accounts - Get connected accounts
• GET /api/social/auth/:platform - Start OAuth flow
• POST /api/social/callback/:platform - OAuth callback
• DELETE /api/social/accounts/:id - Disconnect account

🎯 Usage Examples

Register a New User

curl -X POST http://localhost:5000/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"password123"}'

Generate AI Content

curl -X POST http://localhost:5000/api/ai/generate-content \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "topic": "productivity tips for remote workers",
    "tone": "professional",
    "length": "medium",
    "platform": "linkedin"
  }'

Create a Post

curl -X POST http://localhost:5000/api/posts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "content": "Excited to share our new productivity tips!",
    "platforms": ["twitter", "linkedin"],
    "scheduledAt": "2025-09-24T10:00:00Z"
  }'

🚀 Next Steps

Immediate Enhancements

1. Redis Setup: Configure Redis for job queue functionality
2. OAuth Integration: Complete social media platform connections
3. Image Upload: Add image attachment capabilities
4. Email Notifications: Post success/failure notifications

Advanced Features

1. Team Collaboration: Multi-user workspace support
2. Content Calendar: Visual scheduling interface
3. Advanced Analytics: Detailed engagement metrics
4. AI Improvements: Better content suggestions and optimization
5. Mobile App: React Native mobile application

🔒 Security Features

• JWT Authentication: Secure token-based authentication
• Password Hashing: bcrypt for secure password storage
• Rate Limiting: API request throttling
• CORS Protection: Cross-origin request security
• Input Validation: Comprehensive data validation
• Security Headers: Helmet.js security middleware

📊 Performance Optimizations

• Lazy Loading: Component and route-based code splitting
• Caching: Redis caching for frequently accessed data
• Database Indexing: Optimized MongoDB queries
• Image Optimization: Next.js automatic image optimization
• Bundle Analysis: Webpack bundle optimization

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📄 License

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

---

Built with ❤️ using Next.js, Node.js, and AI