Nudge - Advanced AI Sales Outreach Platform

Nudge is a cutting-edge, AI-powered sales engagement platform designed to automate personalized cold outreach sequences. By leveraging generative AI and intelligent workflow automation, Nudge helps modern sales teams scale their outbound efforts without sacrificing personalization.

---

Screenshots

🚀 Features

🤖 Intelligent Automation

• AI-Generated Copy: Uses Google Gemini 1.5 Flash to craft hyper-personalized emails based on prospect data.
• Smart Sequences: Automated multi-step email campaigns with custom time delays.
• Reply Detection: Automatically stops follow-ups when a lead replies, preventing awkward double-messaging.

📊 Powerful Analytics

• Real-time Dashboard: Tracks emails sent, open rates, reply rates, and bounce rates.
• Campaign Insights: Granular performance metrics for each specific campaign.
• Lead Scoring: (Coming Soon) AI-driven prioritization of high-intent prospects.

🛠️ Robust Infrastructure

• Idempotent Workflows: Built on Inngest for reliable, durable execution of complex email sequences.
• High Deliverability: Integrated with Resend for enterprise-grade email infrastructure.
• Secure Auth: Authentication powered by Clerk, ensuring data privacy and security.

---

🏗️ Tech Stack

Frontend (Client)

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: Shadcn UI + Radix UI
• Animations: Framer Motion
• State Management: TanStack Query
• Icons: Lucide React

Backend (Server)

• Framework: FastAPI (Python)
• Database: PostgreSQL
• ORM: SQLModel (SQLAlchemy + Pydantic)
• AI Model: Google Gemini API
• Background Jobs: Inngest
• Email Service: Resend

---

🛠️ Getting Started

Prerequisites

• Node.js 18+
• Python 3.10+
• PostgreSQL
• Bun (optional, but recommended for frontend)

Installation

1. Clone the repository

   git clone https://github.com/yourusername/nudge.git
   cd nudge

2. Frontend Setup

   cd client
   bun install
   bun dev

3. Backend Setup

   cd backend
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install -r requirements.txt
   uvicorn app.main:app --reload

4. Inngest Dev Server

   npx inngest-cli@latest dev

Environment Variables

Create .env files in both client and backend directories.

Backend (backend/.env)

DATABASE_URL=postgresql://user:password@localhost:5432/nudge_db
GEMINI_API_KEY=your_google_api_key
RESEND_API_KEY=re_123456789
CLERK_SECRET_KEY=sk_test_...
INNGEST_SIGNING_KEY=sign_...

Frontend (client/.env.local)

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
NEXT_PUBLIC_API_URL=http://localhost:8000

---

📂 Project Structure

nudge/
├── backend/
│   ├── app/
│   │   ├── api/          # REST API endpoints
│   │   ├── core/         # Config & security
│   │   ├── db/           # Database engine
│   │   ├── models/       # SQLModel definitions
│   │   ├── schemas/      # Pydantic schemas
│   │   ├── services/     # Business logic
│   │   └── workflows/    # Inngest workflows
│   └── tests/
├── client/
│   ├── app/
│   │   ├── (auth)/       # Authentication pages
│   │   ├── (dashboard)/  # App dashboard layout
│   │   └── pages/        # Landing pages
│   ├── components/       # Reusable UI components
│   └── lib/              # Utilities & API hooks
└── README.md

📄 License

Distributed under the MIT License. See LICENSE for more information.

---