Repolode
Submit
cmintey

cmintey/wishlist

A self-hosted, shareable wishlist app where friends and family can view and claim gifts without duplicating purchases.

Open-source alternative to:Amazon Wish ListGiftster

View on GitHub
Stars
681
Forks
64
Open issues
48
Last commit
2 days ago

What is it?

Wishlist is a self-hosted web application for maintaining gift wishlists that friends and family can browse. Members can organize wishes into multiple groups, such as one for friends and another for family, with each group's lists kept separate. Anyone viewing a wishlist can claim an item, and the owner stays unaware of who claimed what, so duplicate gifts are avoided.

Items can be added manually or created by pasting a product URL, which fetches the product details automatically. A bookmarklet also lets users send the page they are viewing straight to their list. Other people can suggest items to a wishlist, with options to require approval, auto-approve, or hide suggestions from the recipient.

The app runs with Docker Compose using SQLite storage, and it supports SMTP for email invitations and password resets, OAuth via OpenID Connect, and proxy header authentication. A Registry Mode turns a group into a single public list that visitors can claim from without an account.

Key features

  • 01Claim items on a shared wishlist and mark them as purchased
  • 02Create wishes by pasting a product URL to fetch details automatically
  • 03Manage multiple separate groups, such as friends and family
  • 04Suggest items to others with approval, auto-approval, or hidden options
  • 05Public Registry Mode for a single list shared by link
  • 06Login via OAuth (OpenID Connect) or reverse proxy headers

Use cases

  • Sharing holiday gift ideas with parents and grandparents who want an easy interface
  • Running a family gift registry for birthdays or weddings through a public link
  • Coordinating gift giving within a friend group without duplicate purchases
  • Hosting a private gift list on a home server or NAS

Quick start

  1. 1

    Create a docker-compose.yaml file with the Wishlist service

  2. 2

    Start the application in the background

    docker compose up -d
  3. 3

    Open the app in your browser at http://<host>:3280

Things to know

  • It is self-hosted, so you need your own server and Docker to run it.
  • It does not support being served from a subpath behind a reverse proxy.

In collections

Self-hosted appsDatabases & SQL toolsLogin, SSO & identity servers

Topics

#wishlist#gift-registry#self-hosted#docker#sqlite#oauth#pwa#typescript#christmas#family

FAQ

What is wishlist?
A self-hosted, shareable wishlist app where friends and family can view and claim gifts without duplicating purchases. Wishlist is a self-hosted web application for maintaining gift wishlists that friends and family can browse. Members can organize wishes into multiple groups, such as one for friends and another for family, with each group's lists kept separate. Anyone viewing a wishlist can claim an item, and the owner stays unaware of who claimed what, so duplicate gifts are avoided.
Is wishlist free to use? What license does it have?
wishlist is open source under the MIT license. Check the license terms before using it in commercial products.
Is wishlist still maintained?
Actively maintained. The last commit to wishlist was on Nov 5, 2026.
What can I use wishlist for?
Sharing holiday gift ideas with parents and grandparents who want an easy interface Running a family gift registry for birthdays or weddings through a public link Coordinating gift giving within a friend group without duplicate purchases Hosting a private gift list on a home server or NAS
How do I install wishlist?
Create a docker-compose.yaml file with the Wishlist service Start the application in the background: docker compose up -d Open the app in your browser at http://<host>:3280
Where can I get wishlist?
The source code and installation instructions are on GitHub: https://github.com/cmintey/wishlist

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects