Welcome to Secret Santa, a web application that allows you to organize a Secret Santa gift exchange with your friends, family, or colleagues. The application is built using React written in TypeScript (Javascript) with Next.js framework, nodemailer, Ant Design, Tailwind, Prisma ORM, and TRPC.
The structure of the application was bootstrapped with create-t3-app.
- Create a group and add a list of people and their emails.
- The application matches the people and emails them secretly to tell them who they will be getting a gift for.
- Members of the group can upload hints for their Secret Santa.
- The Secret Santa is notified by email when their receiver uploads hints of want.
You can access the live website at santa.maravian.com.
- Clone the repository.
- Setup the environment variables for you database and SMTP credentials for email functionality renaming the .env.example to .env and filling the values
- Install the dependencies using
yarn install. - Updating the database with the schema
yarn db:push. - Run the application using
yarn dev.
- Create a group and add a list of people and their emails.
- The application randomly matches the people and emails them secretly to tell them who they will be getting a gift for.
- Members of the group can upload hints for their Secret Santa.
- The Secret Santa is notified by email when a member of the group uploads their hints.
- If the types of the values depending the database suddenly go missing or invalid, run
npx prisma generateto make/update the types from the schema and db.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.