From f6cea9e41e05c9172c29c981478a45c73d499d47 Mon Sep 17 00:00:00 2001 From: Benny <66417262+ThisIsBenny@users.noreply.github.com> Date: Sun, 20 Feb 2022 15:28:51 +0100 Subject: [PATCH] Update README.md --- README.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 69fcbf0..fe37582 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# wishlist +# Wishlist App The wishlist app is a simple webapp for publishing wishlists. It allows to share wishlists for different people or occasions with friends and family. If something from the wishlist was bought, it can be removed from the list to prevent duplicate purchases. @@ -37,6 +37,20 @@ services: - ./data:/app/data ``` +## Usage + +When you open the app for the first time, you have to enter the API key. To do this, click the icon on the right in the header or open the `/login` page. If the API key is stored, a toggle for the edit mode appears in the header. The edit mode allows you to create new wishlists or edit existing ones. + +If you want add new entries to the wishlist, open a wishlist and activate the edit mode. To more easily to add something to the wishlist, you can create a bookmark with the following content (replace [DOMAIN] with your own domain): + +`javascript:window.location='[DOMAIN]/add-wishlist-item?url=' + window.location` + +Now you can select the bookmark on a product page. This will redirect you to the app and pre-fill the form with the Open Graph data from the original page. + +Once the wish list is ready, it can be shared with friends and family. They have the option to remove purchased items from the wish list so that they are not bought a second time. + +Wishlists that have been set as non-public can only be opened with a deep link. They do not appear on the start page (unless the API key is set). + ## Development Guide ```sh