Customer App
Complete guide for customers — discover bouquets on the map, manage your cart, place orders, and track deliveries.
Browse Bouquets
Bouquet Map (Guest)
The main discovery screen. An interactive map shows bouquet markers near your selected location. The filter panel (left) lets you search by address, choose a search radius (1–15 km), and use your device's GPS. Each flower-icon marker represents an available bouquet — click it to see a popup with the photo, price, vendor name, and an Add to Cart button.
Bouquet Map (Logged In)
The same map view when signed in. The navigation bar now shows Orders, Favourites, Subscriptions, and the cart icon. Your account email appears in the top-right user menu.
Bouquet Details
Full detail page for a single bouquet: large photo, name, description, price, freshness information, vendor profile with star rating, and distance from your location. Click Add to Cart to purchase, or the heart icon to save as a favourite.
Authentication
Login via Keycloak
FlowerShop uses Keycloak for secure authentication. Enter your registered email and password, or click Register to create a new account. You are redirected here automatically when accessing any protected page (Cart, Orders, Profile).
Shopping
Shopping Cart
Your cart shows all bouquets you have selected, with photos, names, vendor, price per item, and the order subtotal. All items must be from the same vendor — adding a bouquet from a different vendor starts a new cart. Click Checkout to proceed to payment.
My Orders
Order History
Full history of all your orders. Use the status tabs to filter: All / Pending / Paid / Preparing / In Delivery / Completed / Cancelled. Each row shows the order ID, date, number of items, total, and current status. Click Details to open a full order view.
Order Details
Detailed view of a single order: bouquet photo, name, vendor, price, delivery address, payment reference, and a status timeline showing every step from placement to delivery.
My Account
Favourites
Your saved favourite bouquets. Click the heart icon on any bouquet or vendor card to add them here. Use this page to quickly re-order from vendors you have bought from before.
Subscriptions
Manage your vendor subscriptions. Subscribing to a vendor means you will receive push notifications whenever they list new bouquets in your area. Toggle subscriptions on or off from this list.
My Profile
Your personal information: display name, email address, and phone number. Keep this up to date so vendors can contact you about your orders.
Saved Addresses
Manage delivery addresses for faster checkout. Add, edit, or delete addresses and mark one as your default. The default address is pre-filled during checkout.
