Skip to content
Flex Storefront

Requirements

Flex Storefront is a modern, native app storefront for SAP Commerce Cloud. The storefront codebase is a Flutter app that relies exclusively on the Commerce REST API for its data and business logic.

In order to install and run Flex Storefront, you will need a Flutter development environment, a running SAP Commerce Cloud instance, and a Firebase Project. The instructions below will guide you through these prerequisites.

Frontend Requirements

Installing Flutter and Dart

To set up a Flutter development environment, follow these steps:

  1. Install Flutter SDK:

    • Download the Flutter SDK from the official Flutter website.
    • Extract the downloaded ZIP file to a location on your machine.
    • Add the Flutter bin directory to your system’s PATH variable.

  2. Install Dart SDK:

    • Flutter requires the Dart SDK. Download and install it from the Dart website.

  3. Configure Flutter:

    • Run flutter doctor in your terminal to check if there are any dependencies you need to install to complete the setup.
    • Install any missing dependencies as suggested by the flutter doctor command.

  4. Set Up IDE:

    • Choose an Integrated Development Environment (IDE) such as Visual Studio Code or Android Studio.
    • Install the Flutter and Dart plugins for your chosen IDE.

  5. Verify Installation:

    • Run flutter --version in your terminal to verify that Flutter is installed correctly.
    • Run dart --version to verify Dart installation.

We recommend a minimum of Flutter 3.24.3 and Dart 3.5.3

Backend Requirements

SAP Commerce Cloud Installation

Flex Storefront uses SAP Commerce Cloud for its backend and makes use of the sample data. Composable storefront can only be used with SAP Commerce Cloud 2211 or newer; the latest release is recommended.

For the full guide, see Setting up SAP Commerce Cloud for use with Flex Storefont.

Below is a high level overview of the steps required to install and run SAP Commerce Cloud:

  1. Download SAP Commerce Cloud:

    • Access the SAP Commerce Cloud 2211 download from the SAP Software Center and download the necessary installation files.

  2. Installation Process:

    • Follow the installation guide provided by SAP to set up SAP Commerce Cloud on your local machine or server.
    • Configure the necessary settings such as database connection details, server configurations, etc.

  3. Start SAP Commerce Cloud:

    • Once the installation is complete, start the SAP Commerce Cloud server according to the instructions provided.

  4. Verify Installation:

    • Access the SAP Commerce Cloud administration console via a web browser to ensure that the installation was successful.

Firebase Project Setup

Flex Storefront uses Google Firebase as a mobile backend to configure and power composable commerce features in the Storefront app.

To set up Firebase, follow these steps:

  1. Create a Firebase Project:

  2. Add Firebase to your App:

    • Follow the on-screen instructions to add Firebase to your Flutter app.
    • Download the google-services.json file and place it in the appropriate location in your Flutter project.

  3. Configure Firebase Services:

    • Enable the Firebase services you require for your project, such as Firestore, Authentication, Cloud Functions, etc.