🎂 Birthday Bot — Automated Birthday Message Sender

An automated birthday message sender that designs beautiful gift cards and delivers heartfelt emails to both the celebrant and you.

Features

• Beautiful Dashboard — Manage all birthdays with live countdowns
• Auto Gift Card Generation — 6 stunning themes (Sunset, Ocean, Forest, Rose, Midnight, Gold)
• Dual Emails — Celebrant gets a personal message + gift card; you get a notification with a preview
• Personalized Messages — Auto-generated by relationship type, or write your own
• Daily Scheduler — Checks birthdays every day at 8 AM UTC automatically
• Send Now — Manually trigger any birthday message instantly

Quick Start

1. Install dependencies

pip install -r requirements.txt

2. Configure email

Create a .env file (copy from .env.example):

SENDER_EMAIL=your_email@gmail.com
SENDER_APP_PASSWORD=xxxx xxxx xxxx xxxx
SENDER_NAME=Your Name
SECRET_KEY=your-random-secret
SIGNATURE=With love

Gmail App Password: Go to myaccount.google.com/apppasswords, create an app password for "Mail". Make sure 2FA is enabled on your account first.

3. Run the app

python app.py

Open http://localhost:5050 in your browser.

How It Works

1. Add birthdays via the dashboard (name, email, date, relationship, card theme)
2. The scheduler runs daily at 8 AM — automatically finds today's birthdays and sends emails
3. Each birthday sends two emails:
   • 🎂 To the celebrant — A warm, personalized message with a beautifully designed gift card
   • 🔔 To you — A notification email with delivery confirmation and a card preview
4. Use Send Now to manually fire a message at any time

Card Themes

Theme	Colors
🌅 Sunset	Orange → Gold
🌊 Ocean	Deep Blue → Cyan
🌲 Forest	Dark Green → Lime
🌹 Rose	Deep Pink → Light Rose
🌙 Midnight	Navy → Purple
✨ Gold	Brown → Golden