diff --git a/packages/bookshop/README.md b/packages/bookshop/README.md
new file mode 100644
index 00000000..6342e2b4
--- /dev/null
+++ b/packages/bookshop/README.md
@@ -0,0 +1,47 @@
+# Bookshop With Address Data From S/4HANA
+
+This is an extended bookshop with business-partner address data from S/4HANA.
+When the user creates an order, using the value help of the shipping address 
+triggers a synchronous request to S/4HANA yielding all possible addresses
+belonging to this business partner. Once an address is selected, its data
+is replicated into a local database. To keep data in sync, an event handler
+is registered listening to all changes of business partners updating the 
+local database table.
+
+## Prerequisites
+
+###  S/4HANA Cloud System (Non-Mock Case)
+To run your app in non-mock mode you need an S/4HANA Cloud system and connect it to your SAP Cloud Platform. You can use the
+[SAP Cloud Platform Extension Factory](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/346864df64f24011b49abee07bbd79af.html) to automate parts of this task. You need to enable synchronous APIs as well as events that are sent whenever business partners are changed.
+
+To run the app locally, you need to create a `default-env.json` file in the `bookshop` folder containing the binding information (credentials of Enterprise Messaging as well as the destination to the business-partner service).
+
+
+## Running With Mocks
+Just execute the following command in the `bookshop` folder.
+```
+cds run --in-memory --with-mocks
+```
+
+## Running With an S/4HANA Backend
+Provide the credentials in the `cds.requires` section of the `package.json` file in the `bookshop` folder, e.g.
+```json
+      "API_BUSINESS_PARTNER": {
+        "kind": "odata",
+        "model": "srv/external",
+        "credentials": {
+          "destination": "cap-api532",
+          "prefix": "sap/S4HANAOD/c532/BO"
+        }
+      }
+```
+Here, `destination` is the destination of your business-partner service and `prefix` is the prefix
+of the topic of the events.
+
+Then simply run the following command in the `bookshop` folder.
+```
+cds run --in-memory
+```
+
+## User Flow
+After starting the app, go to http://localhost:4004/fiori.html#Shell-home and open the app `Manage Orders` to create an order.
\ No newline at end of file