toxik / SecretSanta

Secret Santa project to pick present pairs for your colleagues and send them emails. Guaranteed cryptographically secure random function :)

Secret Santa shuffler and email sender

This little project takes a list of persons, shuffles everybody without showing the pairs and then sends every one an email with their present receiver. It is currently translated into English and Romanian. There's an HTML template (in the templ folder) which is used to give a nice winter-y form to the emails.

Here's a screenshot from a Gmail received message:

Installation

1. git clone https://github.com/toxik/SecretSanta.git
2. cd SecretSanta && npm install (for the nodemailer dependency)

Usage

1. clone the settings.json.sample into settings.json
2. add the details for the persons you want shuffled: name, email, sex
3. configure your email provider (smtp/gmail etc. see the nodemailer project for all available settings)
4. npm start

Credits

Alexandru Georoceanu

License

MIT