🚀 Bulk Email Sender v2.0

Professional Laravel-based email marketing solution with advanced contact management

---

✨ Features

What's New in v2.0:

• 👥 Contact Management - Complete contact database with tags and categories
• 📧 Individual Emails - Send personalized emails to specific contacts
• 🏷️ Tag System - Organize and target contacts with custom tags
• 📊 Excel Import/Export - Seamlessly import contacts from CSV/Excel files
• 🎨 Modern UI - Clean, responsive design with breadcrumb navigation
• � Queue System - Background email processing with Laravel Queues

Core Features:

• ✅ Bulk email sending with HTML templates
• ✅ Contact management with tagging system
• ✅ Excel/CSV import and export
• ✅ Email validation and verification
• ✅ Multi-SMTP support
• ✅ Real-time delivery tracking

---

�🛠️ Prerequisites

• PHP: 8.1+
• Composer: Latest version
• Laravel: 10.x
• Database: MySQL 5.7+ or PostgreSQL 10+
• SMTP Server: Gmail, SendGrid, Mailgun, etc.

---

⚡ Installation

1. Clone and setup

   git clone https://github.com/arafat-web/Bulk-Email-Sender.git
   cd Bulk-Email-Sender
   composer install
   cp .env.example .env
   php artisan key:generate

2. Database setup

   # Configure database in .env file
   php artisan migrate --seed

3. Email configuration in .env

   MAIL_MAILER=smtp
   MAIL_HOST=smtp.gmail.com
   MAIL_PORT=587
   MAIL_USERNAME=your-email@gmail.com
   MAIL_PASSWORD=your-app-password
   MAIL_ENCRYPTION=tls

4. Queue setup (Choose one option)

   Option A: Instant Mode (Default - No Queue Worker)

   # In .env file:
   QUEUE_CONNECTION=sync
   
   # Start application
   php artisan serve

   ✅ Emails send immediately
   ✅ No queue worker needed
   ⚠️ Slower for large campaigns

   Option B: Queue Mode (Recommended for Production)

   # In .env file:
   QUEUE_CONNECTION=database
   
   # Start application
   php artisan serve
   
   # In a separate terminal, start queue worker:
   php artisan queue:work --queue=emails,default

   ✅ Fast campaign creation
   ✅ Better for bulk emails
   ✅ Automatic retries
   📖 See QUEUE-SETUP.md for details

5. Check queue status anytime

   php artisan queue:status

Default Login: admin@email.com / 12345678

---

📸 Screenshots

Dashboard Overview

Contact Management

Email Templates

Individual Email Sending

Instant Campaign

Tag Management

Email Accounts Settings

User Profile

Login Page

---

🎮 How to Use

📧 Bulk Email Campaign

1. Navigate to "Instant Campaign"
2. Import contacts via CSV/Excel or use existing contacts
3. Write your email subject and content
4. Send to all contacts or specific tags

👥 Contact Management

1. Go to "Contacts" → "Add Contact" for individual entries
2. Use "Import Contacts" for bulk CSV/Excel uploads
3. Organize contacts with tags
4. Export contact lists when needed

🏷️ Tag System

1. Create tags in "Contact Tags" section
2. Assign tags to contacts for organization
3. Send targeted emails to specific tag groups
4. Filter contacts by tags for better management

---

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

For issues and feature requests, use GitHub Issues.

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

📱 Connect With Me

---

⭐ If you found this project helpful, please give it a star! ⭐

Made with ❤️ by Arafat Hossain