🚀 LeadForge AI

AI-powered B2B sales assistant for lead discovery, website auditing, and personalized outreach.

---

Features

• 🔍 AI Lead Discovery — Search for businesses by industry and city, automatically scrape contact details
• 🔎 Website Auditor — SSL, mobile responsiveness, meta tags, performance scoring
• ✉️ Gmail Integration — Connect Gmail via OAuth 2.0, send personalized outreach campaigns
• 🤖 AI Email Assistant — Generate cold outreach emails using Google Gemini AI
• 📊 CRM Pipeline — Track leads through New → Contacted → Qualified → Proposal → Won/Lost stages
• 🧠 AI CEO Dashboard — Executive insights, pipeline health scores, strategic recommendations
• 💳 Payment Module — Manual UPI payment verification with admin approval
• 📈 Analytics Dashboard — Revenue, users, leads, emails, and conversion metrics
• 🔐 JWT Authentication — Secure session management with bcrypt password hashing
• 🎯 Guided Onboarding — Step-by-step setup wizard for new users

---

Tech Stack

Layer	Technology
Backend	Node.js, Express 5
Frontend	Vanilla HTML/CSS/JS
AI Engine	Google Gemini API
Auth	JWT + bcrypt
Email	Gmail API (OAuth 2.0)
Database	JSON file-based (db.json)
Deployment	Docker, Railway, Render, Koyeb

---

Quick Start

git clone https://github.com/Samarth1306w/LeadForge-AI.git
cd LeadForge-AI
cp .env.example .env
# Edit .env with your credentials
npm install
npm start

Open http://localhost:3000

---

Environment Variables

See .env.example for the complete list.

Key variables:

• GEMINI_API_KEY — Google Gemini AI API key
• GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET — Gmail OAuth credentials
• JWT_SECRET — Session signing key

---

Deployment

See DEPLOYMENT.md for full guides covering:

• Railway (recommended free tier)
• Render
• Koyeb
• Docker

---

Project Structure

leadforge-ai/
├── server.js              # Express application entry point
├── database.js            # JSON database with atomic writes
├── aiEngine.js            # Google Gemini AI integration
├── auditor.js             # Website technical audit engine
├── scraper.js             # B2B directory scraper
├── gmailService.js        # Gmail OAuth service layer
├── integrations.js        # Reddit + Email OAuth integrations
├── controllers/           # Route controllers (modular)
│   ├── admin/
│   ├── ceo/
│   ├── gmail/
│   ├── google/
│   └── sdr/
├── routes/                # Express route modules
├── services/              # Business logic services
│   ├── ceo/
│   ├── gmail/
│   ├── google/
│   └── sdr/
├── public/                # Frontend assets
│   ├── index.html
│   ├── app.js
│   └── style.css
├── Dockerfile
├── docker-compose.yml
├── .env.example
└── DEPLOYMENT.md

---

License

ISC