KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

GiftHub

★ 19 Open GitHub ↗

A web application that makes it simple to organize, contribute to, and manage gifts for any celebration

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="public/GiftHub.logo.png" alt="logo" width="200" height="auto" />
  <h1>GiftHub</h1>
  
  <h3>
    <a href="https://edu.info.uaic.ro/ingineria-programarii/Scoala/2026/SE/index.html">Software Engineering</a> 2025 - <a href="https://info.uaic.ro/amazon-learn-and-earn/">Learn&Earn</a> winner.
  </h3>
  <p>
    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.
  </p>
  

<p>
  <a href="https://github.com/E3-GiftHub/GiftHub/graphs/contributors">
    <img src="https://img.shields.io/github/contributors/E3-GiftHub/GiftHub" alt="contributors" />
  </a>
  <a href="">
    <img src="https://img.shields.io/github/last-commit/E3-GiftHub/GiftHub" alt="last update" />
  </a>
  <a href="https://github.com/E3-GiftHub/GiftHub/network/members">
    <img src="https://img.shields.io/github/forks/E3-GiftHub/GiftHub" alt="forks" />
  </a>
  <a href="https://github.com/E3-GiftHub/GiftHub/stargazers">
    <img src="https://img.shields.io/github/stars/E3-GiftHub/GiftHub" alt="stars" />
  </a>
  <a href="https://github.com/E3-GiftHub/GiftHub/issues/">
    <img src="https://img.shields.io/github/issues/E3-GiftHub/GiftHub" alt="open issues" />
  </a>
  <a href="https://github.com/E3-GiftHub/GiftHub/blob/master/LICENSE">
    <img src="https://img.shields.io/github/license/E3-GiftHub/GiftHub.svg" alt="license" />
  </a>
</p>

https://github.com/user-attachments/assets/94fe2d17-7ebd-485f-8451-ccdf78bd2b10

<h4>
    <a href="docs/demo.mp4">View Full Demo</a>
  <span> · </span>
    <a href="https://docs.google.com/document/d/1Yh1Eaa5I0w-tF8_Y4AJZoDLe8aI6ZBTnuGBTjD6-4MU/edit?tab=t.0">Documentation</a>
  <span> · </span>
    <a href="https://github.com/E3-GiftHub/GiftHub/issues/">Report Bug</a>
  <span> · </span>
    <a href="https://github.com/E3-GiftHub/GiftHub/issues/">Request Feature</a>
  </h4>
</div>

<br />

# :notebook_with_decorative_cover: Table of Contents

- [About the Project](#star2-about-the-project)
  - [Screenshots](#camera-screenshots)
  - [Tech Stack](#space_invader-tech-stack)
  - [Features](#dart-features)
  - [Color Reference](#art-color-reference)
  - [Environment Variables](#key-environment-variables)
- [Getting Started](#toolbox-getting-started)
  - [Prerequisites](#bangbang-prerequisites)
  - [Run Locally](#running-run-locally)
  - [Run Tests](#test_tube-running-tests)
- [Contributing](#wave-contributing)
  - [Code of Conduct](#scroll-code-of-conduct)
- [License](#warning-license)
- [Acknowledgements](#gem-acknowledgements)

## :star2: 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.

### :camera: Screenshots

<div align="center"> 
  <video alt="demo section" width="600" height="350" controls>
    <source src="docs/demo-section.mp4" type="video/mp4">
  Video tag not supported Navigate to docs/demo.mp4 to see the full demo.
  </video>

### :space_invader: Tech Stack

<details>
  <summary>Client</summary>
  <ul>
    <li><a href="https://www.typescriptlang.org/">Typescript</a></li>
    <li><a href="https://nextjs.org/">Next.js</a></li>
    <li><a href="https://reactjs.org/">React.js</a></li>
    <li><a href="https://tailwindcss.com/">TailwindCSS</a></li>
  </ul>
</details>

<details>
  <summary>Server</summary>
  <ul>
    <li><a href="https://www.typescriptlang.org/">Typescript</a></li>
    <li><a href="https://nestjs.com/">Nest.js</a></li>
    <li><a href="https://www.prisma.io/">Prisma</a></li>
    <li><a href="https://uploadthing.com/">Uploadthing</a></li>
    <li><a href="https://docs.stripe.com/api/">Stripe</a></li>
    <li><a href="https://developer.ebay.com/develop/get-started/">Ebay</a></li>
  </ul>
</details>

<details>
<summary>Database</summary>
  <ul>
    <li><a href="https://www.postgresql.org/">PostgreSQL</a></li>
    <li><a href="https://supabase.com/">Supabase</a></li>
  </ul>
</details>

### :dart: 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.

### :art: Color Reference

| Color           | Hex     | Color                                                                                            |
| --------------- | ------- | ------------------------------------------------------------------------------------------------ |
| Primary Color   | #18103A | ![#18103A](https://img.shields.io/badge/-18103A.svg?style=flat-square&label=+&labelColor=18103A) |
| Secondary Color | #31176B | ![#31176B](https://img.shields.io/badge/-31176B.svg?style=flat-square&label=+&labelColor=31176B) |
| Accent Color    | #47338A | ![#47338A](https://img.shields.io/badge/-47338A.svg?style=flat-square&label=+&labelColor=47338A) |
| Text Color      | #C6A9D5 | ![#C6A9D5](https://img.shields.io/badge/-C6A9D5.svg?style=flat-square&label=+&labelColor=C6A9D5) |

### :key: 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](.env.example)

## :toolbox: Getting Started

### :bangbang: Prerequisites

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

```bash
  npm -v
  node -v
```

### :running: Run Locally

Clone the project

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

Go to the project directory

```bash
  cd GiftHub
```

Install dependencies

```bash
  npm install
```

Build the source code

```bash
  npm run build
```

Start the server

```bash
  npm run dev
```

### :test_tube: Run Tests

To run tests, run the following command

```bash
  npm run test
```

## :wave: Contributing

Contributions are always welcome!

### :scroll: Code of Conduct

Please read the [Code of Conduct](https://github.com/E3-GiftHub/GiftHub/blob/master/CODE_OF_CONDUCT.md)

## :warning: License

Distributed under the GPL-3.0. See [LICENSE](LICENSE) for more information.

## :gem: Acknowledgements

- [README template](https://github.com/Louis3797/awesome-readme-template)
- [Shields.io](https://shields.io/)
- [Emoji Cheat Sheet](https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md#travel--places)

GiftHub

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README