Navigation structure

Every app ships with five-tab bottom navigation: Home, Search, Cart, Wishlist, and Account. Each tab has its own navigation stack, so tapping a product in Search pushes the product detail screen within the Search stack without resetting the Home tab. The cart icon shows a live badge count that updates as items are added or removed. Tab colors and active-state indicators use your brand color token, so they are consistent with the rest of your branding without any manual styling.

Home screen

The home screen is fully block-based. What renders, and in what order, is determined by your Builder > Home layout configuration. The default layout includes a hero banner or image carousel at the top (configurable as a hero block or image-slider block with either a slide or crossfade transition), a featured collections row that scrolls horizontally, a new arrivals section, and a best sellers section. Pull-to-refresh reloads all sections from Shopify in one gesture.

You can reorder any block, remove sections you don't want, or add additional collection rows targeting specific collections in your Shopify store. The block system is the same pattern across every screen — see Per-screen layouts and the Block reference for the full list of available block types.

Product discovery

Collection browsing includes a collection list screen showing a grid of all collections in your Shopify store, each tapping through to a collection detail screen with the products grid for that collection. Tapping any product opens the product detail screen.

Full-text search returns results in real time as the customer types, pulling from the Shopify Storefront API search endpoint. Results can be filtered by price range, in-stock only, and sorted by price low-to-high, price high-to-low, newest, or best selling. Search history is stored on device and shows the last 10 searches when the search bar is focused, letting customers quickly return to previous queries. The history is cleared when the customer logs out.

The product detail screen includes a full image gallery with pinch-to-zoom, a variant picker that surfaces every Shopify variant option (size, color, material, or any custom option the merchant has set up), compare-at price shown alongside the sale price with a sale badge, inventory status (in stock, low stock, or out of stock), and the full product description rendered natively from Shopify's rich text format. Reviews render via a WebView injection of the merchant's existing Shopify review app, which means Judge.me, Okendo, Yotpo, and other review apps work without any per-client integration work. Add to cart and add to wishlist are available on every product regardless of variant selection state, and the native share sheet lets customers share product links.

Cart and checkout

The cart screen shows all line items with full variant information (size, color, or whatever options the merchant uses), quantity controls to increment, decrement, or remove each item, a running subtotal, and a discount code field. Entering a valid Shopify discount code updates the subtotal and displays the applied discount immediately, without requiring a page reload.

Checkout is Shopify's native hosted checkout, opened in an in-app browser. Shopify handles shipping address collection, shipping method selection, payment (card, Apple Pay, Google Pay, cash on delivery, and every other payment method the merchant has configured in their Shopify Payments or third-party payment provider settings), and order confirmation. Appolar does not re-implement checkout. This means the merchant's existing Shopify checkout customizations, upsell apps, and buy-now-pay-later configurations work in the app without any additional setup.

Account and orders

Guest browsing is fully supported. A customer can browse products, view collections, search, and read product detail pages without logging in. Login is required for checkout (Shopify requires authentication), wishlist sync across devices, and order history.

Login uses Shopify Customer Account credentials — the same email and password the customer uses on the merchant's web store. A customer who already has an account on the merchant's Shopify website can log in to the app immediately with the same credentials. Registration creates a new Shopify customer record. Password reset is handled by Shopify's standard password reset email flow, keeping the experience consistent with the web store.

The account screen lets customers view and edit their profile (name, email, phone), change their password, and manage a saved address book (add, edit, delete, and set a default address for checkout pre-fill). Shortcuts to order history and wishlist are accessible from the same screen. Order history shows all past orders with status (processing, fulfilled, delivered, cancelled, or refunded), line items, pricing, applied discounts, tracking numbers, and shipping carrier information. Wishlist syncs to Shopify customer metafields when the customer is logged in and falls back to local device storage for guests, so a guest's wishlist is preserved across sessions on the same device.

What's not included at launch

These features are either post-MVP or handled by Shopify natively and require no Appolar-specific work: