GiftHub

Software Engineering 2025 - Learn&Earn winner.

Say goodbye to awkward gift planning - this platform makes it easy to give and receive the perfect presents by pooling contributions and creating collaborative wishlists.

demo-section.mp4

View Full Demo · Documentation · Report Bug · Request Feature

📔 Table of Contents

• About the Project
  • Screenshots
  • Tech Stack
  • Features
  • Color Reference
  • Environment Variables
• Getting Started
  • Prerequisites
  • Run Locally
  • Run Tests
• Contributing
  • Code of Conduct
• License
• Acknowledgements

🌟 About the Project

The platform aims to address the logistical challenges associated with group gifting, prevent duplicate gifts, efficiently manage monetary contributions, and provide a seamless and enjoyable gifting experience for both Event Planners and Guests. Gifting for events like weddings and birthdays often involves significant coordination. Planners face difficulties in communicating their preferences to Guests, managing contributions from multiple individuals, and dealing with the possibility of receiving unwanted duplicate gifts. Guests, on the other hand, may struggle to find suitable gifts, coordinate with others, and contribute conveniently.

This platform provides a centralized digital solution to these problems by enabling Event Planners to create and manage wishlists, allowing Guests to easily contribute financially or purchase gifts directly, and ensuring secure and transparent transaction processing.

📷 Screenshots

👾 Tech Stack

Client

• Typescript
• Next.js
• React.js
• TailwindCSS

Server

• Typescript
• Nest.js
• Prisma
• Uploadthing
• Stripe
• Ebay

Database

• PostgreSQL
• Supabase

🎯 Features

• Wishlist Creation: Event organizers can easily create and manage wishlists, adding items from a catalog of products sourced from various online retailers (e.g. Ebay).
• Gift Pooling: Guests can pool money together to fund more expensive gifts on the wishlist, making it easier to contribute towards something special.
• Cash Gifts: An option for guests to leave cash gifts through a secure payment gateway, providing flexibility in how they wish to contribute.
• Party photo/video gallery: Guests can upload images taken at the event to share with the other participants.
• Duplicate Prevention: The platform will track purchased items in real-time, updating the wishlist to prevent duplicate gifts.
• Payment Integration: Utilize Stripe Connect to manage transactions, ensuring a secure and efficient payment process for both collecting contributions and disbursing funds to the celebrant or for the purchase of gifts.

🎨 Color Reference

Color	Hex	Color
Primary Color	#18103A
Secondary Color	#31176B
Accent Color	#47338A
Text Color	#C6A9D5

🔑 Environment Variables

To run this project with all of its features, you will need to add all the environment variables present in this example file

🧰 Getting Started

‼️ Prerequisites

This project uses npm as package manager. If not installed navigate to https://nodejs.org/en/download. Check its installation

  npm -v
  node -v

🏃 Run Locally

Clone the project

  git clone https://github.com/E3-GiftHub/GiftHub.git

Go to the project directory

  cd GiftHub

Install dependencies

  npm install

Build the source code

  npm run build

Start the server

  npm run dev

🧪 Run Tests

To run tests, run the following command

  npm run test

👋 Contributing

Contributions are always welcome!

📜 Code of Conduct

Please read the Code of Conduct

⚠️ License

Distributed under the GPL-3.0. See LICENSE for more information.

💎 Acknowledgements

• README template
• Shields.io
• Emoji Cheat Sheet