🚀 LeadFast AI

---

📖 Overview

LeadFast AI is a real-world SaaS platform that helps home service contractors respond to customer inquiries within seconds. It captures website form submissions, generates personalized AI-powered replies, sends emails automatically, and stores every interaction in a secure dashboard. 0

---

✨ Features

• ⚡ Instant lead capture
• 🤖 AI-generated responses
• 📧 Automated email delivery
• 📊 Lead management dashboard
• 🔐 Secure authentication
• 🛡️ Row-Level Security (RLS)
• ☁️ Serverless deployment
• 📱 Responsive interface

---

🛠 Tech Stack

Category	Technologies
Frontend	Next.js • TypeScript • Tailwind CSS
Backend	Next.js API Routes
Database	Supabase • PostgreSQL
Authentication	Supabase Auth
AI	Anthropic Claude API
Email	Resend
Deployment	Vercel
Version Control	Git & GitHub

---

🏗 Architecture

Customer
    │
    ▼
Website Contact Form
    │
    ▼
 Embed Script
    │
    ▼
 Next.js API
    │
    ├────────────► Supabase Database
    │                     │
    ▼                     ▼
Claude AI          Dashboard
    │
    ▼
Resend API
    │
    ▼
Customer Reply

---

📂 Project Structure

LeadFast_AI/
│
├── NextJs/
│   ├── app/
│   ├── components/
│   ├── lib/
│   ├── public/
│   └── ...
│
├── Supabase/
│   ├── schema.sql
│   ├── rls.sql
│   ├── billing.sql
│   └── pipeline.sql
│
└── README.md

---

⚙️ How It Works

1. Customer submits a website form.
2. Lead is captured by the embed script.
3. Next.js processes the request.
4. Claude AI generates a personalized reply.
5. Resend sends the email.
6. Supabase stores the lead and response.
7. Contractors manage everything from the dashboard. 1

---

🚀 Quick Start

Clone the repository

git clone https://github.com/adoka254/LeadFast_AI.git
cd LeadFast_AI/NextJs

Install dependencies

npm install

Configure environment variables

Copy NextJs/.env.example to NextJs/.env.local and fill it in. Run Supabase/schema.sql, Supabase/rls.sql, Supabase/billing.sql and Supabase/pipeline.sql in your Supabase project.

Run locally

npm run dev

---

🔒 Security

• Contractor data is only readable by its owner (Supabase Auth + Row-Level Security; API routes verify the access token).
• Public lead intake validates input, rate-limits per IP, and only accepts leads for an existing business.
• Billing state is written only by verified Stripe webhooks.

---

💳 Billing

• 14-day free trial on sign-up, no card required.
• Starter ($49/mo, 100 instant replies a month) and Pro ($99/mo, unlimited) via Stripe Checkout; customers manage cards and cancel in the Stripe portal.
• When a trial ends or a plan's monthly replies run out, leads are still saved and the contractor is still emailed; only the automatic customer reply pauses.

---

🌍 Deployment

Hosted on cPanel (Setup Node.js App). See DEPLOY.md.

Service	Purpose
cPanel Node.js	Hosting
🗄 Supabase	Database & Authentication
🤖 Gemini / Claude	AI Responses
📧 Resend	Email Delivery
💳 Stripe	Subscriptions

---

👥 Team

Benoline Mildren	Shamah Kibet
Samuel Muriithi	Steve Were
Valentine Ombunga	Bacil Otieno
Frank Nyaundi	Dorcas Adoka

---

📚 Documentation

Project documentation includes:

• System Architecture
• Database Design
• AI Workflow
• Deployment Strategy
• Product Roadmap
• Risk Assessment

See the full documentation for implementation details and technical decisions. 2

---

📄 License

This repository showcases LeadFast AI, a real-world SaaS platform built to automate lead engagement and improve customer response times for home service contractors.

---