🚀 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
- Customer submits a website form.
- Lead is captured by the embed script.
- Next.js processes the request.
- Claude AI generates a personalized reply.
- Resend sends the email.
- Supabase stores the lead and response.
- 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.
