Wishlist

Wishlist is a self-hosted web application used for creating and sharing gift registries with friends and family. It allows users to maintain lists of desired items that others can view and claim to avoid duplicate gifts during holidays or special events. The application provides a centralized location for managing gift ideas, ensuring that the process of selecting presents is coordinated across different family members or social groups.

The software is deployed as a server application, typically using Docker Compose or a Helm chart. It is accessible via a web browser and includes PWA support for a more native experience on mobile devices. Users can manage their lists through a web interface, while administrators can configure the instance via environment variables to set global defaults for currency and image upload limits.

Key features

• Claim items on a wishlist to notify others
• Mark claimed items as purchased
• Automatic product data fetching from URLs
• Support for multiple separate groups for different social circles
• Registry mode for single-user public lists without account requirements
• User invitations via SMTP email or manual links
• OAuth authentication via OpenID Connect
• Suggestion system with approval or surprise modes

The application uses a SQLite database for data storage and supports custom currency settings on a global or per-item basis. For authentication, it integrates with third-party identity providers such as Authelia, Authentik, Keycloak, and Google. It also offers a proxy header authentication method for users running the app behind a reverse proxy, allowing the proxy to handle user identity. To simplify adding items, a bookmarklet can be configured to send product URLs directly from a browser to a specific list, reducing the need for manual data entry.

Group management allows for different levels of access, where group managers can invite users or modify group settings. The registry mode specifically caters to events where a single person needs a public list that guests can interact with without needing to create an account. This is achieved by providing a public link where guests identify themselves by name or email when claiming an item.

Wishlist is designed for individuals and families who want a private, self-managed way to coordinate gift giving.