shop homepage - BevvyTech/BrewskiDocs GitHub Wiki
- Reserved area for super user / admin teams to curate marketplace homepage content.
- Access limited to teams flagged as super users or platform admins; operations call the authenticated shop APIs (
/shop/homepage-promotions*,/shop/teams/search,/shop/homepage-hero,/shop/homepage-featured-groups,/shop/teams/:teamId/groups). - Featured group assignments surface through the public feed consumed by the storefront (
/public/homepage/settings) so the marketing site can render the same pair of groups. - Promotion images are capped at 5 MB and resized to 1300 px width; hero artwork supports up to 8 MB, must be at least 770 px tall, and is downscaled to 770 px height (with a warning when the upload isn’t 1920 px wide) before persisting as JPEG for the public
/public/heroconsumer.
- Breadcrumbs allow navigation back to Dashboard or Shop overview.
- “Team preview” card lets operators search for a team, choose the promotion start date/time, upload the hero image, and schedule (or edit) a promotion.
- Left column hosts platform-wide controls:
- Top menu card lists navigation toggles for the public shop header; switches call
/shop/navigation(GET/PATCH) and immediately enable or hide themenu.topitems such as Home, Shop by, partner links, and the header icons. Disabling theAccounttoggle removes the desktop avatar/menu portal and the mobile account entry so the storefront header shows no account affordance. - Notice strip toggles the small banner above the shop (enable switch, message text, optional link) via platform settings.
- Featured groups card sits beneath the hero editor and above the services strip; super/support operators pick two breweries (autocomplete backed by
/shop/teams/search), then choose one of each brewery’s shop-visible groups (fetched from/shop/teams/:teamId/groups). Saving each slot issuesPUT /shop/homepage-featured-groups/:position, clearing callsDELETEon the same route, and the public homepage consumes the saved slots from/public/homepage/settings. - Hero editor captures category, title, message copy, theme (
dark/light), optional call-to-action (text + link), display duration (seconds each slide stays visible), and a large hero image (previewed inline, replaceable before saving).
- Top menu card lists navigation toggles for the public shop header; switches call
- Saved hero slides appear in a table beneath the editor—operators can review the category, title, and last update timestamp, load an entry back into the form for edits, delete unused slides with confirmation, and bump slides up or down with compact icon buttons to adjust the carousel order.
- Text styling controls live alongside the hero copy: toggle whether the overlay needs a background, pick between light/dark overlays at 15% or 85% alpha (selector stays visible but disabled until the toggle is on), and select a mandatory text colour.
- Scheduled promotions appear beneath the form; edit/delete actions sit behind a 3-dot menu consistent with the beers grid, and the summary badges surface the stored background scheme and text colour using the locale strings.
- Exactly one promotion is marked as the default fallback; it carries a “Default” pill, exposes a “Make default” action for non-default entries, and hides the delete option for the active default.
- The card surfaces the fallback team (oldest team by created date) when no promotions exist so the homepage always has a featured brewery.
-
shop.home.latest-carousels— toggles the three “Latest”, “Fresh casks”, and “Fresh kegs” sliders on the public homepage. -
shop.home.shop-all-button— shows or hides the “Shop all beers” call-to-action that sits beneath the latest carousel. -
shop.home.team-promotion— controls whether the featured team promotion block renders on the homepage. -
shop.home.essential-accessories— governs whether the “Essential accessories” upsell carousel appears. -
shop.home.breweries-links— toggles click-through access on the brewery logo carousel while keeping the marquee visible. -
shop.home.services-strip— enables the four-card services strip (free shipping, returns, support, payment). -
feature.collection-points— controls whether the footer shows the “Find collection location closest to me” link. -
shop.home.newsletter— toggles the “Good emails” newsletter signup column in the footer. -
shop.wishlist.enabled— disables storefront wishlist buttons, drawer, and persistence when turned off. -
shop.top.search-icon— hides the search CTA in the top header bar when disabled, keeping the offcanvas modal unreachable.
All flags default to enabled when no explicit override is present so the page maintains existing content for teams without targeted rollouts.