✉️ Bulk Outreach Personalizer & Campaign Orchestrator

A secure, zero-installation, serverless bulk outreach platform. Connect spreadsheet lead lists (Excel/CSV), map personalized placeholder variables, preview custom drafts dynamically, and execute targeted email campaigns directly inside the browser using secure Yahoo OAuth2 streams or rate-limited Mailto dispatches.

👉 Live Interactive Demo Link

---

✨ Features Checklist

• Zero-Server Architecture: Runs 100% in-browser. Your uploaded lead files never touch an external server, protecting sensitive business information.
• Universal Spreadsheet Parser: Instant, robust CSV and Excel (.xlsx, .xls) file parsing powered by SheetJS, with automatic records and columns detection.
• Glassmorphic Design System: Modern dark-mode UI tokens featuring clean typography (Plus Jakarta Sans), responsive layouts, custom scrollbars, and micro-interactions.
• Pausable Campaigns: Direct campaign dispatcher equipped with pause, resume, and real-time dispatch progress tracking.
• Robust UI Error System: Integrated custom toast alert notification engine (Success, Error, Warning, Info) and beautiful modal prompts to replace browser defaults.
• Excel Status Reports: Generates detailed, downloadable campaign delivery logs (Excel_Report.xlsx) indicating success, failure, or skipped records.

---

🛠️ Tech Stack & Libraries

• Markup & Layout: HTML5, Semantic DOM architecture.
• Styling: Vanilla CSS3 Custom Tokens, blur filters, CSS variables, keyframe animations, and custom scrollbars.
• File Processing: SheetJS (xlsx.full.min.js) for sheet arrays compilation.
• Visuals & Icons: Lucide Icons for crisp, scalable vectors.
• Integrations: Yahoo OAuth 2.0 Implicit Auth, standard RFC Mailto stream.

---

🏗️ Architecture Workflow

graph TD
    A[Upload Excel/CSV] -->|SheetJS Parsing| B(Detect Records & Columns)
    B --> C[Configure Template Variables]
    C -->|Smart Column Mapper| D{Template Design}
    D -->|Injected {logo} & {link}| E[Real-Time Compose Previews]
    E --> F[Select Delivery Method]
    F -->|Secure OAuth 2.0| G[Yahoo campaign stream]
    F -->|Bypass popups| H[RFC Mailto campaign queue]
    G --> I[Excel dispatch reports]
    H --> I

Loading

---

🚀 Quick Setup & Run Locally

Since the application is 100% client-side, running it locally is incredibly simple:

1. Clone the repository:

   git clone https://github.com/Jawknee-builds/bot-for-sales.git
   cd bot-for-sales

2. Launch immediately:

   • Double-click the index.html file on your system to open it directly in any browser.
   • Alternatively, serve it locally using Python:

     python3 -m http.server 8000

     Then navigate to http://localhost:8000.

---

🎗️ Yahoo Developer Portal Config

To send campaigns directly through the Yahoo Mail API:

1. Visit the Yahoo Developer Network.
2. Create an App and select the Client-Side (Implicit) Authorization flow.
3. Configure the Redirect URI callback exactly to: https://jawknee-builds.github.io/bot-for-sales/ (or http://localhost:8000/ if testing locally).
4. Under API Permissions, select Mail (Read & Write).
5. Copy the generated Client ID and Client Secret directly into the application dashboard, and launch your campaign!

---

📄 License

This project is open-source and available under the MIT License.

---

Developed with 💜 by Jawknee-builds