> For the complete documentation index, see [llms.txt](https://developer.emporix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.emporix.io/frontend/overview.md).

# Overview

When a customer arrives at the storefront, the homepage acts as the starting point for the shopping journey. At the top of the page, the customer sees a navigation bar with quick links to all the main areas, from browsing categories and viewing new collections to checking the account and cart. A search bar is always within reach, so the customer can find specific products instantly. As the customer scrolls down the page, the navigation bar remains visible but transitions to a more compact format to avoid disrupting the shopping experience.

At the front, there is also a dynamic banner showing current promotions, new arrivals, or seasonal offers. Depending on tenant customization settings, these displays can also function as featured product sections. For example, a customer can quickly scan each item along with its image, name, and price. From there, the customer can either select an item to see more details or add it directly to the cart or wishlist.

A customer can also find personalized recommendations on the homepage. These suggestions are based on previous browsing activity and interactions. It is an easy way to discover relevant items without searching.

### Navigation and browsing

<figure><img src="/files/IqQtqfLAevtcjhGeDM7K" alt=""><figcaption><p>Product listing page showing products in a category</p></figcaption></figure>

Products are organized in a hierarchical category structure that customers can browse through the main navigation menu. Customers can navigate through main categories and subcategories, and use the breadcrumb trail at the top of the page to see the current location and navigate back to previous levels. The frontend also includes a search bar that allows customers to quickly find products by product name, item number, or keywords.

{% hint style="info" %}
Our tenants can be integrated with BatteryIncluded, Algolia, or any other search engine provider.
{% endhint %}

### Product details page

<figure><img src="/files/u8zgudWwxnglyObvmaUx" alt=""><figcaption><p>Product details page with images, pricing, and specifications</p></figcaption></figure>

When a customer selects a product, the customer is taken to the product details page, which displays multiple product images, comprehensive product information including title, item number, and promotion badges, as well as customer ratings and pricing details with VAT breakdown. The page shows availability status, shipping costs, and reservation options, along with trust indicators like warranty information and return policies. Customers can add products to the cart directly from the product page, specify quantities, and view detailed specifications, descriptions, and product highlights that explain the product's features and benefits.

### Product comparison

From product listing and product details views, customers can add products to a comparison list and then open the comparison page to review specifications side-by-side. Rows with differences between compared products (for example, **Price**) are highlighted in bold so they are easier to spot.

<figure><img src="/files/2CFPtwtcOersfNdL0wnp" alt=""><figcaption><p>Adding products to comparison from product listing</p></figcaption></figure>

<figure><img src="/files/l9XvqBeGX9NS6SvdEAhQ" alt=""><figcaption><p>Product comparison view with side-by-side specifications</p></figcaption></figure>

#### Ordering and checkout

As customers add products, items appear in the shopping cart where selections can be reviewed before placing an order. Customers can update quantities, remove items, and review totals at any time.

<figure><img src="/files/dTMd9bQHfBNxwyW3Ii00" alt=""><figcaption><p>Cart view</p></figcaption></figure>

Customers can proceed to checkout either as registered users or as guests. Guest checkout allows customers to place orders without creating an account, while still generating an order record that the merchant can process in the management dashboard.

During checkout, customers provide shipping and billing details, choose delivery and payment options, and review the final order summary. Promo or coupon codes can be applied during this step, with updated totals displayed immediately.

For B2B scenarios, additional purchasing flows are available. Customers can request a quote directly from the cart, allowing merchants to review the request and respond with a negotiated offer. Some organizations may also use approval-based purchasing, where an order is submitted internally for approval before it is finalized.

Once the order is confirmed, it becomes visible to both the customer and the merchant, marking the completion of the storefront journey.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.emporix.io/frontend/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
