Cross‑platform desktop app to:

• Look up students with birthdays on a selected date (year‑agnostic filtering)
• Generate a personalized AI birthday message
• Create a custom birthday card image
• Send emails
• Include father/mother contact details automatically if present

• Date picker (filters by MM-DD; year ignored)
• Token authentication (login once; cached client side for 1 hour)
• Dark / Light theme toggle
• Excel-based data source with parent contact info
• SendGrid email sending with card PNG attachment
• AI-generated birthday text (Groq API)
• Parent (father/mother) emails + phones auto-included in sends

Create a .env:

EMAIL_USER
GROQ_API_KEY
PORT
AUTH_USER
AUTH_PASS
APP_SECRET
CERTIFICATE_PASSWORD
EMAIL_PASSWORD
EMAIL_SENDER

1. Install Electron dependencies:

npm install

2. Run development mode:

npm start

Read the server README.md file.

Electron Forge scripts:

# Dev
npm start

# Make distributables 
npm run make

# Windows-only quick package (with icon)
npm run package

Output artifacts go to out/ or the forge default (out / make subfolders).

• Jay-Karia
• shaunbenedict

MIT – see LICENSE.