stacksimplify/retail-store-sample-ui repository overview

This is a sample application designed to illustrate various concepts related to containers on AWS. It presents a retail store demo application that includes a product catalog, shopping cart, and checkout system.

⁠Key Features

• 🛍️ A demo storefront UI with:

  • Themed pages
  • Application topology insights
  • A generative AI chatbot
  • Utility functions for experimentation and learning

• 🧩 Distributed architecture with services written in multiple languages and frameworks

• 💾 Multiple persistence backends supported: MariaDB (or MySQL), DynamoDB, Redis

• ⚙️ Runs on various orchestration platforms:

  • Docker Compose
  • Kubernetes

• 🖥️ Pre-built multi-arch container images for:

  • x86_64 and arm64 CPUs

• 📊 Observability built-in:

  • Prometheus metrics
  • OpenTelemetry OTLP tracing

• 🔐 Istio support on Kubernetes

• 🔁 Includes a load generator to simulate traffic and usage patterns

📘 For full setup instructions and source code, visit the official GitHub repository: 👉 Retail Store Sample App on GitHub⁠

⁠⚠️ Important Disclaimer

For original documentation and upstream details, see: 🔗 AWS Retail Store Sample App GitHub⁠

⁠🏗️ Application Architecture

This project is intentionally over-engineered to simulate real-world microservices architecture. Each component is decoupled and may depend on a unique set of backend services or data stores.

⁠🚀 Quickstart: Run with Docker

⁠Pre-requisites

• Docker installed on your local machine

⁠Run the UI container

docker run -it --rm -p 8888:8080 stacksimplify/retail-store-sample-ui:1.0.0

⁠Access the application

Open your browser and go to:

http://localhost:8888

⁠Stop the container

Use Ctrl + C to stop the container gracefully.