Berakah - Viral Content Repurposing Engine

AI-powered platform that transforms technical blog posts into high-engagement social media content using Groq and Motia.

🚀 Features

• Smart Content Ingestion: Paste any blog URL and let AI analyze it
• Multi-Platform Generation: Creates Twitter threads and LinkedIn posts
• Real-time Processing: Watch the AI think with live "Vibe Console" updates
• Human-in-the-Loop: Review and approve before posting
• Professional UI: Clean, business-ready interface with shadcn/ui
• Bot Safety: Randomized delays and human approval workflow

🏗️ Architecture

Backend (Motia Framework)

• Unified Step Architecture: APIs and Event Workers in one system
• Groq Integration: High-speed AI generation using Llama 3.1
• State-Based Anti-Hallucination: Locks source content to prevent AI fabrication
• Event-Driven Processing: BullMQ for reliable background jobs

Frontend (Next.js 16)

• App Router: Modern React architecture
• Vibe Console: Real-time processing logs
• Zustand: Type-safe global state management
• Tailwind v4: High-performance styling

📁 Project Structure

berakah/
├── backend/              # Motia backend
│   ├── src/
│   │   └── steps/
│   │       └── repurpose/
│   │           ├── ingest.step.ts      # API: Accepts URL
│   │           ├── process.step.ts     # Worker: AI Generation (Groq)
│   │           ├── publish.step.ts     # Worker: Safe Publishing
│   │           ├── approve.step.ts     # API: Human Approval
│   │           └── retrieve.step.ts    # API: Polling
│   └── motia.config.ts
├── frontend/             # Next.js frontend
│   ├── src/
│   │   └── app/
│   ├── components/
│   ├── lib/
│   ├── stores/
│   └── types/

🛠️ Tech Stack

Backend

• Motia: Unified backend framework
• Groq SDK: Ultra-fast AI inference (Llama 3.1)
• Zod: Schema validation
• Redis: In-memory or external state storage

Frontend

• Next.js 16: Latest React framework
• TypeScript: Full type safety
• Tailwind CSS: Utility-first styling
• Shadcn/UI: Accessible components
• Zustand: State management

🚦 Getting Started

1. Backend Setup

   cd backend
   npm install
   # Configure .env with GROQ_API_KEY
   npm run dev

2. Frontend Setup

   cd frontend
   npm install
   npm run dev

3. Usage

   • Open http://localhost:5240
   • Paste a blog URL
   • Watch the AI generate content
   • Review and Click "Approve & Publish"

📄 License

MIT