AI-Powered Outreach Automation Platform — Automate lead management, personalized outreach, follow-ups, and campaign analytics from one unified platform.
Portfolio notice
This repository is a portfolio and case-study representation of the product.
Source code, credentials, infrastructure, prompts, workflows, and proprietary implementation details are intentionally excluded.
The repository exists solely to demonstrate architecture, engineering decisions, automation workflows, and product design.
Explore the deployed application: https://outreach.ahmedhussain.tech/
| Built by | Maria Bano — AI Automation Engineer |
| Domain | B2B sales — cold email, lead generation, outreach automation |
| Pattern | SaaS dashboard → lead processing → AI personalization → email delivery → follow-ups → analytics |
| Repository type | Public portfolio — product showcase, not a source-code release |
One line: A multi-tenant SaaS platform that imports leads, generates AI-personalized cold emails, runs multi-step follow-up sequences via Gmail, and tracks replies, bounces, and campaign performance.
Watch the full walkthrough on LinkedIn:
https://www.linkedin.com/posts/maria-bano-ai_n8n-apollo-openai-activity-7457871029554700289-En4m
This demo covers the full outreach automation pipeline — from lead import through AI personalization, campaign launch, Gmail delivery, follow-up sequences, and analytics. You'll see n8n workflow automation, Apollo enrichment, and OpenAI-powered email drafts in action.
Also featured: Product showcase on LinkedIn
| Demo segment | What you'll see |
|---|---|
| Lead import | CSV upload and spreadsheet organization |
| Campaign setup | Sequence config, scheduling, Gmail sender |
| AI personalization | n8n + OpenAI research and draft generation |
| Email delivery | Scheduled sending via Gmail API |
| Follow-ups | Multi-step sequence automation |
| Analytics | Dashboard metrics and campaign performance |
See demo/README.md for hosting and archival options.
LeadMaster is a full-stack outreach automation platform for agencies, sales teams, and B2B operators who need to run personalized cold email campaigns at scale without sacrificing quality or control.
The platform unifies the entire outreach lifecycle:
- Import and organize prospect lists from CSV, Excel, or external enrichment sources
- Segment leads into categories and campaign-ready files
- Generate AI-personalized emails using website and LinkedIn research
- Schedule and send via connected Gmail accounts with human-like cadence
- Automate follow-ups across multi-step email sequences
- Track performance with reply detection, bounce handling, and analytics dashboards
Unlike generic email blast tools, LeadMaster combines structured campaign management, AI-driven personalization, and native email delivery in a single tenant-isolated SaaS experience.
| Feature | Capability |
|---|---|
| Lead Management System | Organize prospects into categories, files, and spreadsheet rows with bulk editing |
| CSV/Excel Import | Upload prospect lists with column mapping and validation |
| Apollo Lead Import | Enrich and import B2B leads from external prospect databases |
| Lead Segmentation | Group leads by vertical, campaign, or custom categories |
| Campaign Management | Create, configure, launch, pause, and monitor outreach campaigns |
| AI Email Personalization | Generate tailored subject lines and body copy per lead |
| Website Research | Automated company website analysis for personalization context |
| LinkedIn Research | Profile and company research to enrich outreach messaging |
| Automated Follow-Ups | Multi-step sequences with configurable delays and send times |
| Email Scheduling | Timezone-aware drip scheduling with daily send limits |
| Reply Detection | Inbox monitoring to detect and flag lead replies |
| Bounce Tracking | Automatic bounce detection and suppression on future campaigns |
| Analytics Dashboard | Campaign metrics, weekly trends, and performance charts |
| Reporting | Sent, replied, bounced, and completion stats at campaign and account level |
| Exact Email Campaign System | Targeted one-to-one campaigns with precise lead-to-email mapping |
| Multi-Step Campaign Automation | Initial email plus follow-up stages with state-driven progression |
Capabilities are documented at the product level. Implementation details, prompts, and workflow internals remain private.
Screenshots below are UI mockup placeholders generated for the portfolio. Replace them with sanitized captures from the live product before publishing — see screenshots/README.md for capture instructions.
Main analytics view — active campaigns, emails sent, reply rate, bounce rate, and weekly performance trends.
Campaign configuration — daily send limits, timezone, Gmail sender, and multi-step follow-up sequences.
Spreadsheet-style lead organization with bulk editing, status tracking, and category/file structure.
Campaign performance metrics — sent, replied, bounced, and completed counts with trend visualization.
Daily campaign reporting — sent, replied, and bounced stats broken down by date.
AI personalization pipeline — website/LinkedIn research and OpenAI draft generation via workflow automation.
Manual step: Log in at outreach.ahmedhussain.tech, capture each view with fictional data, save to
screenshots/, and replace the placeholders above. Also updateassets/dashboard-preview.png.
LeadMaster follows a layered SaaS architecture that separates user interaction, campaign orchestration, AI enrichment, email delivery, and analytics.
flowchart TD
A["React Frontend"] --> B["Campaign Management API"]
B --> C["Lead Processing Engine"]
C --> D["AI Personalization Engine"]
D --> E["Email Delivery Layer"]
E --> F["Follow-Up Engine"]
F --> G["Analytics & Reporting"]
G --> H["Database"]
D -.-> I["n8n Workflow Automation"]
E -.-> J["Gmail API"]
H -.-> K["Supabase PostgreSQL"]
| Layer | Role |
|---|---|
| Frontend | Dashboard, lead spreadsheet, campaign builder, templates, settings |
| Campaign Management | REST API for campaigns, leads, files, and user-scoped operations |
| Lead Processing | Import, validation, segmentation, and campaign assignment |
| AI Personalization Engine | External workflow automation for research and draft generation |
| Email Delivery | Native sending via Gmail API with scheduling and jitter |
| Follow-Up Engine | Sequence progression, reply/bounce detection, state management |
| Analytics | Aggregated stats, daily metrics, and dashboard views |
| Database | Multi-tenant data store with row-level security |
Deep dive: docs/architecture.md · CASE_STUDY.md
B2B sales teams and agencies spend hours on repetitive outreach tasks — importing leads, researching prospects, writing personalized emails, scheduling sends, tracking replies, and managing follow-ups across spreadsheets and disconnected tools.
| Pain point | Impact |
|---|---|
| Manual lead list management | Error-prone spreadsheets, no single source of truth |
| Generic email templates | Low reply rates, poor deliverability perception |
| Disconnected enrichment tools | Context switching between Apollo, LinkedIn, and email clients |
| No follow-up automation | Leads go cold; revenue opportunities missed |
| Limited visibility | No unified analytics across campaigns and senders |
| Deliverability risk | Bulk sending without human-like cadence triggers spam filters |
Goal: Build a unified platform that automates the full outreach lifecycle while maintaining tenant isolation, deliverability best practices, and operational control.
LeadMaster delivers an end-to-end outreach automation platform:
- Import leads via CSV, Excel, or external enrichment sources
- Organize and segment prospects in a spreadsheet-style interface
- Launch campaigns with timezone, daily limits, and sequence configuration
- Personalize with AI using website and LinkedIn research via workflow automation
- Send via Gmail with human-like scheduling and jitter
- Automate follow-ups across configurable multi-step sequences
- Track results with reply detection, bounce suppression, and analytics dashboards
The architecture uses a hybrid automation model: external workflow automation handles AI enrichment, while native background workers manage email delivery, inbox monitoring, and campaign state.
| Layer | Technologies |
|---|---|
| Frontend | React, Vite, Tailwind CSS, AG Grid, Zustand |
| Backend | FastAPI, Python, APScheduler |
| Database | Supabase (PostgreSQL) with Row-Level Security |
| Authentication | Supabase Auth (JWT) |
| Email Delivery | Google Gmail API (OAuth 2.0) |
| AI & Automation | n8n workflow automation, OpenAI (via external workflows) |
| Lead Enrichment | Apollo (import integration), website/LinkedIn research |
| Hosting | Cloud-deployed SaaS (production environment private) |
| Decision | Rationale |
|---|---|
| Hybrid n8n + native workers | n8n for flexible AI workflows; native workers for reliable email send and inbox monitoring |
| Gmail API over ESP bulk sending | Authentic per-user sending from real inboxes — better for cold outreach deliverability |
| Multi-tenant Supabase with RLS | Tenant isolation at the database layer; JWT-scoped API access |
| Lead state machine | Explicit statuses enable predictable campaign progression and debugging |
| Human-like send cadence | Random jitter and daily limits reduce spam-filter triggers |
| DB views for analytics | Pre-aggregated dashboard stats without heavy runtime computation |
| Portfolio-only public repo | Demonstrates engineering depth without exposing proprietary assets |
Full rationale: CASE_STUDY.md · docs/architecture.md
| Outcome | Impact |
|---|---|
| Reduced manual outreach effort | Hours per campaign eliminated via automated import, personalization, and sending |
| Scalable AI personalization | Every lead receives research-backed, tailored copy — not generic templates |
| Automated follow-up consistency | Multi-step sequences run without manual tracking or missed touchpoints |
| Centralized analytics | Reply rates, bounce rates, and campaign performance in one dashboard |
| Faster campaign execution | Launch campaigns in minutes — not days of spreadsheet prep and manual writing |
| Better lead management efficiency | Spreadsheet-style UI with categories, bulk editing, and status tracking |
AI Automation · SaaS Development · n8n · OpenAI · Email Automation · Lead Generation · Workflow Automation · Analytics · System Design
| Skill | Evidence |
|---|---|
| Full-Stack SaaS Development | React frontend + FastAPI backend + Supabase |
| AI Automation Engineering | n8n workflow integration for personalization pipelines |
| Email Automation | Gmail API integration, scheduling, follow-up sequences |
| System Design | Layered architecture with hybrid automation model |
| Multi-Tenant Architecture | RLS, JWT auth, user-scoped data access |
| Background Job Processing | Scheduled workers for send, scrape handoff, and inbox monitoring |
| Data Pipeline Design | Lead import, enrichment, state machine, analytics aggregation |
| Product Engineering | End-to-end B2B outreach platform from import to analytics |
| Portfolio Discipline | Architecture documentation without exposing proprietary assets |
See Skills Signal above for the full breakdown. Additional context in docs/interview-talking-points.md.
LeadMaster-SaaS/
├── README.md # Product overview and architecture summary
├── CASE_STUDY.md # Business case study and engineering narrative
├── LICENSE # CC BY 4.0 (documentation)
├── SECURITY.md # Security policy and portfolio boundary
├── CONTRIBUTING.md # Documentation contribution guidelines
├── docs/
│ ├── architecture.md # System design with Mermaid diagrams
│ ├── interview-talking-points.md
│ ├── demo-checklist.md
│ └── github-profile-setup.md
├── demo/ # Demo video guidelines
├── assets/ # Banners, diagrams, social preview images
├── screenshots/ # Product screenshots (placeholders → replace manually)
├── examples/ # Fictional API and contract examples
└── .github/ # Issue and PR templates
| Document | Description |
|---|---|
| CASE_STUDY.md | Executive summary, business value, technical decisions |
| docs/architecture.md | Full system design with 7 Mermaid diagrams |
| docs/interview-talking-points.md | Pitch scripts and interview Q&A |
| docs/demo-checklist.md | Screenshot and video asset tracking |
| docs/github-profile-setup.md | GitHub profile and repo visibility setup |
| examples/ | Fictional API request/response examples |
| SECURITY.md | Security policy and portfolio boundary |
| Channel | Link |
|---|---|
| Live Product | outreach.ahmedhussain.tech |
| Maria Bano | |
| Demo Video | LinkedIn Walkthrough |
| Product Showcase | LinkedIn Post |
| mariabano.official@gmail.com |
Documentation, diagrams, and case study materials in this repository are licensed under Creative Commons Attribution 4.0 (CC BY 4.0).
This license applies to portfolio documentation only. It does not grant rights to proprietary source code, workflows, prompts, or production systems, which remain private and are not published in this repository.