🎅 Secret Santa Magic: Email-Enabled Gift Exchange Organizer 🎄 Transform the holiday gift-giving experience! This unique project combines the joy of Secret Santa with the convenience of technology, featuring a web service that not only assigns your Secret Santa but also discreetly notifies each participant via email. Perfect for friends, family, and office parties!
This Secret Santa application facilitates the organization of a Secret Santa gift exchange. It allows participants to be added, assigns Secret Santas randomly, and sends email notifications with assignments. The application supports both English and Spanish languages.
- Participant Management: Add and manage participants with names, emails, and exclusion lists.
- Secret Santa Assignment: Randomly assign Secret Santas among participants, ensuring that no one gets their excluded individuals or themselves.
- Multilingual Support: Seamlessly switch between English and Spanish.
- Email Notifications: Automatically send personalized email notifications to each participant with their Secret Santa assignment.
- Frontend: HTML, CSS, JavaScript
- Backend: Node.js
- Email Service: Nodemailer with Hotmail
- Localization: Support for both English and Spanish languages
-
Install Node.js
-
Clone the Repository
git clone https://github.com/MauGaP/maugapsSecretSanta
- Install Dependencies
cd [project_directory]
npm install
- Set Up Environment Variables
Create a .env file in the root directory with the following content:
[email protected]
EMAIL_PASS=your-email-password
- Start the Server
node ./server/server.js
- Open the Application
Access index.html in a web browser.
- Add Participants: Enter participant names, emails, and exclusion criteria.
- Assign Secret Santas: Secret Santas are automatically assigned every time a field is modified.
- Send Email Notifications: Notify participants of their assignments via email.
The application allows users to switch between English and Spanish using a language selector.
Contributions are welcome. Please adhere to the standard fork, branch, and pull request workflow.
MIT
For inquiries or contributions, please contact MauGaP at linkedin.com/in/maugap.