LeadGenius AI

Advanced AI Lead Intelligence and Sales Strategy Assistant

Generate business strategy, discover high-potential leads, and create conversion-focused outreach templates using Google Gemini, Google Maps, and Google Search.

Overview

LeadGenius AI is a Next.js web application that helps sales teams, agencies, and founders move from planning to outreach in one workflow:

1. Define your business profile
2. Generate strategic analysis
3. Discover qualified leads in target geographies
4. Produce personalized outreach sequences
5. Build a final summary report with opportunity insights

The project was originally bootstrapped from Google AI Studio app tooling and extended into a complete, production-ready web app.

UI Preview

Core Features

• Business profile intake with structured targeting inputs
• Magic Auto-Fill using Gemini to convert a plain-language description into form data
• AI strategy generation (business model, 30-day plan, 90-day scaling path)
• Lead discovery powered by Google Maps and Google Search tools
• Lead qualification labels (Hot/Warm/Cold) with in-app status tracking
• CSV export for downstream CRM workflows
• General and lead-specific outreach templates
• Final report generation with conversion and revenue potential framing
• Secure login with role-based access (admin/member)

Tech Stack

• Next.js 15
• React 19 + TypeScript
• Google GenAI SDK (@google/genai)
• Tailwind CSS 4
• React Markdown + remark-gfm
• Lucide icons

Project Structure

• app/page.tsx: Main application workflow UI and AI actions
• app/layout.tsx: Global layout and metadata
• app/globals.css: Global styles
• lib/utils.ts: Shared utility helpers
• hooks/use-mobile.ts: Responsive helper hook

Getting Started

Prerequisites

• Node.js 18+ (Node.js 20 LTS recommended)
• npm 9+
• A Google Gemini API key from Google AI Studio

Quick Start

1. Clone the repository.
2. Install dependencies:

npm install

3. Create an environment file:

cp .env.example .env.local

4. Add required values in .env.local:

GEMINI_API_KEY=YOUR_GEMINI_API_KEY
AUTH_SECRET=YOUR_STRONG_SECRET
APP_ADMIN_EMAIL=admin@example.com
APP_ADMIN_PASSWORD=YOUR_ADMIN_PASSWORD
APP_MEMBER_EMAIL=member@example.com
APP_MEMBER_PASSWORD=YOUR_MEMBER_PASSWORD

5. Start development server:

npm run dev

6. Open http://localhost:3000

Sign in from the in-app login modal using one of the configured credentials.

Available Scripts

• npm run dev: Start local development server
• npm run build: Build for production
• npm run start: Start production server
• npm run lint: Run ESLint
• npm run clean: Clean Next.js artifacts

Environment Variables

• GEMINI_API_KEY: Gemini API key used by backend API routes
• AUTH_SECRET: Signing secret for session cookies
• APP_ADMIN_EMAIL / APP_ADMIN_PASSWORD: Admin login
• APP_MEMBER_EMAIL / APP_MEMBER_PASSWORD: Member login

Security model:

• AI calls run server-side through Next.js API routes
• API key is never stored in browser localStorage
• Access is restricted via signed HTTP-only session cookies

Deployment

Deploy on Vercel (recommended) or any platform that supports Next.js.

Basic Vercel flow:

1. Import repository into Vercel
2. Set all required environment variables from .env.example in project environment variables
3. Deploy

Documentation

• Installation guide: INSTALL.md
• User manual: USER_MANUAL.md
• Contribution guide and credits: CONTRIBUTING.md

Notes

• Keep screenshot.png updated when major UI changes are introduced.
• If login or setup flow changes, update README, INSTALL, and USER_MANUAL in the same PR.

Credits

• Project contributor: Zain Sardar

License

This repository currently does not define a root project license. Add a LICENSE file before public/commercial reuse.