README.md

metadata

title: Certificate Generator
emoji: 📜
colorFrom: blue
colorTo: green
sdk: docker
pinned: false
license: mit

Certificate Generator

A professional certificate generation and email distribution system. Upload your attendee list and certificate template, customize the design, and send personalized certificates via email.

Features

• 📝 Dynamic Certificate Generation: Create personalized certificates from PDF templates
• 📧 Bulk Email Sending: Send certificates to multiple recipients via SendGrid
• 🎨 Custom Design: Position text, adjust fonts, and customize colors
• 📊 Real-time Progress: Live progress tracking for email campaigns
• 🔒 Secure: Environment-based credential management

How to Use

1. Upload Files: Upload your Excel file (with Name and Email columns) and PDF certificate template
2. Design: Position the name text on the certificate and customize styling
3. Configure: Fill in event details (name, date, company) for email templates
4. Send: Monitor real-time progress as certificates are generated and emailed

Configuration

This Space requires the following environment variables to be set in the Settings:

• SENDGRID_API_KEY: Your SendGrid API key for sending emails
• MAIL_FROM_ADDRESS: Verified sender email address in SendGrid

Tech Stack

• Backend: FastAPI, Python, PyMuPDF, SendGrid
• Frontend: React, Vite, TailwindCSS, Framer Motion
• Deployment: Docker

Limitations

⚠️ Ephemeral Storage: Uploaded files and generated certificates are stored temporarily and will be lost when the Space restarts. This is intended for on-demand certificate processing, not long-term storage.

License

MIT License - See LICENSE file for details

Support

For issues or questions, please visit the GitHub repository.